2.3. 결제 상태 조회

2.3.1. 개요

네트워크 이상 등으로 시간이 초과되어, 결제 상태가 불분명 할 경우 가맹은 해당 전문을 통하여, 거래내역을 조회해야 한다.

또한, “결제 요청” 시 응답 결과를 030010로 받았을 경우, 결제 상태 조회를 해야 한다.

거래 후 3일 이내에 대해서만 조회가 가능합니다.

2.3.2. 사용 함수

Map<String, String> data = new HashMap<>();
data.put("merchant_id", merchant_id);               // 가맹점 ID
data.put("merchant_tid", tid);                      // 가맹점 거래 ID
data.put("pay_method", "WECHAT");                   // 결제 수단

Map<String, String> result = chinaPay.payState(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("fk_tid: %s",          result.get("fk_tid")));           // FK 거래 ID
System.out.println(String.format("pay_method: %s",      result.get("pay_method")));       // 결제 수단
System.out.println(String.format("pay_stat: %s",        result.get("pay_stat")));         // 결제 상태
System.out.println(String.format("pay_amt: %s",         result.get("pay_amt")));          // 결제 금액
System.out.println(String.format("pay_auth_code: %s",   result.get("pay_auth_code")));    // 결제 승인 코드
System.out.println(String.format("pay_datetime: %s",    result.get("pay_datetime")));     // 결제 일시

2.3.3. 요청 규격

No	변수명	필수	자료형	길이	비고
1	merchant_id	O	String	15	가맹점 ID
2	merchant_tid	O	String	30	가맹점 거래 ID
3	pay_method	O	String	20	결제 수단

2.3.4. 응답 규격

No	변수명	필수	자료형	길이	비고
1	result_code	O	String	16	응답 코드
2	result_msg	O	String	128	응답 메시지
3	merchant_id	O	String	15	가맹점 ID
4	merchant_tid	O	String	30	가맹점 거래 ID
5	fk_tid	X	String	30	FK 거래 ID
6	pay_method	O	String	20	결제 수단
7	pay_stat	X	String	50	결제 상태 [상태보기]
8	pay_amt	O	Number	16	결제 금액
9	pay_auth_code	O	String	8	결제 승인 번호
10	pay_datetime	X	String	14	결제 일시

2.3.5. 결제 상태 (pay_stat)

No	pay_stat	설명
1	SUCCESS	성공 (MpmCallBack 시 결제성공)
2	REFUND	취소 완료
3	REVOKED	취소 완료
4	PAYERROR	결제 실패
5	USERPAYING	결제 진행 중
6	NOTPAY	결제 진행 중(사용자 비밀번호 요청 전)