2.2. MPM 결제 요청

2.2.1. 개요

이 API를 통해 받은 Barcode 또는 Qrcode를 고객(결제자)가 결제수단의 앱으로 스캔을 하여, 결제를 진행합니다.

결제 결과는 요청 시 전달한 응답 URL을 통해 전달됩니다.

응답 URL을 통해 결과를 통보하지만, “결제 상태 조회” API를 통하여, 가맹점이 적극적으로 결과를 조회할 수 있으며, 5초 이상 간격으로 조회할 것을 권고합니다.

절차1 : 가맹점과 사용자가 결제금액 확인
절차2 : 사용자가 가맹점에게 QRCode를 제시한다.
절차3 : 가맹점은 스캐너를 사용하여, 사용자의 QRCode를 스캔하여, FK에 전송하고, 결과를 기다린다.

2.2.2. 사용 함수

Map<String, String> data = new HashMap<>();
data.put("merchant_id", merchant_id);               // 가맹점 ID
data.put("client_ip", "127.0.0.1");                 // 전송 IP
data.put("merchant_tid", merchant_tid);             // 가맹점 거래 ID
data.put("pay_method", "WECHAT");                   // 결제 수단
data.put("currency", "KRW");                        // 통화
data.put("req_amt", "100");                         // 요청 금액
data.put("req_datetime", datetime);                 // 요청 일시
data.put("notify_url", "http://....");              // 응답 URL

Map<String, String> result = chinaPay.mpmPay(data);

System.out.println(String.format("result_code : %s",    result.get("result_code")));      // 응답 코드
System.out.println(String.format("result_msg : %s",     result.get("result_msg")));       // 응답 메시지
System.out.println(String.format("merchant_id: %s",     result.get("merchant_id")));      // 가맹점 ID
System.out.println(String.format("merchant_tid: %s",    result.get("merchant_tid")));     // 가맹점 거래 ID
System.out.println(String.format("barcode: %s",         result.get("barcode")));          // barcode(또는 Qrcode)
System.out.println(String.format("pay_amt: %s",         result.get("pay_amt")));          // 결제 금액

2.2.3. 요청 규격

No	변수명	필수	자료형	길이	비고
1	merchant_id	O	String	15	가맹점 ID
2	client_ip	O	String	20	전송 IP
3	merchant_tid	O	String	30	가맹점 거래 ID
4	pay_method	O	String	20	결제 수단
5	currency	O	String	3	통화
6	req_amt	O	Number	16	요청 금액
7	req_datetime	O	String	14	요청 일시
8	notify_url	O	String	256	응답 URL

2.2.4. 응답 규격

No	변수명	필수	자료형	길이	비고
1	result_code	O	String	16	응답코드(성공 : 000000, 그외실패:응답코드 참조)
2	result_msg	O	String	128	응답메시지
3	merchant_id	O	String	15	가맹점 ID
4	merchant_tid	O	String	30	가맹점 거래 ID
5	barcode	X	String	128	바코드(또는 QRCode)
6	pay_amt	O	Number	16	결제 금액