결제승인 확인

일정 시간동안 결제승인 완료 노티를 수신하지 못할 경우 사용하는 API 입니다.

주의사항

• 승인결과의 결제금액과 상점의 결제금액이 상이할 시 반드시 취소처리 바랍니다.
• 승인결과에 대한 상점 DB 처리 실패 시 반드시 취소처리 바랍니다

요청

요청 URL

POST https://{API 도메인}/api/trades/wechatpay/find
Content-type: application/json; charset=utf-8

참고

API 멱등성 지원 대상 (API 멱등성 참조)

주의사항

결제승인 확인이 완료되기까지 시간이 걸리므로 timeout을 30초로 설정해야 합니다.

파라미터

필드명	타입	길이	필수여부	설명
mallId	String	8Byte	✅	KICC에서 부여한 상점ID
shopTransactionId	String	60Byte	✅	상점 거래고유번호 (API 멱등성 키)
pgCno	String	60Byte	✅	결제승인 거래고유번호(거래생성 응답으로 받은 값)

요청 예시

{  
   // 결제승인 확인
    "mallId": "{상점ID}", 
    "shopTransactionId": "{API 멱등성 키}", 
    "pgCno": "{결제승인 거래고유번호}"
}

응답

파라미터

필드명	타입	길이	설명
resCd	String	4Byte	응답코드
resMsg	String	1000Byte	응답메시지
shopTransactionId	String	60Byte	요청 시 전송한 값 그대로 사용
mallId	String	8Byte	KICC에서 부여한 상점ID
shopOrderNo	String	40Byte	상점 주문번호 요청 시 전송한 값 그대로 사용
pgCno	String	60Byte	결제승인 거래고유번호
approvalDate	String	14Byte	WeChat Pay 승인일시(yyyyMMddHHmmss)
statusCd	String	4Byte	거래 상태 승인: “TS01”, 전체취소: “TS02”, 부분취소: “TS06”, 망취소: “TS12”
resDetailMsg	String	1024Byte	오류 시 위쳇에서 내려주는 상세 메시지(URL encoding)
amountInfo	Object		결제 금액 정보 (아래 amountInfo 참조)

amountInfo(결제금액 정보)

필드명	타입	길이	설명
currency	String	2Byte	통화코드
totAmount	Number		총 결제금액

응답 예시

{
   "resCd": "0000",
   "resMsg": "정상처리",
   "shopTransactionId": "{API 멱등성 키}",
   "mallId": "{상점ID}",
   "shopOrderNo": "{상점 주문번호}",
   "pgCno": "{결제승인 거래고유번호}",
   "approvalDate": "20230312000512",
   "statusCd": "TS01",   
   "amountInfo": {
      "currency": "KRW",
      "totAmount": 1000
   }
}