결제승인 완료 노티

거래생성 시 요청한 notifyUrl로 결제승인 완료 결과를 받을 수 있습니다. 결제승인 완료 노티를 받기위해 아래와 같이 구현을 해주셔야 합니다.

참고

• WeChat은 결제승인 완료 노티 수신 후 정상응답을 회신하지 않을 경우 아래와 같이 재전송 됩니다.
  • 최대 15회까지 재전송 합니다.
• 일정 시간동안 노티를 수신하지 못할 경우 결제승인 확인 API를 통해 결제상태를 확인하시기 바랍니다.

주의사항

• 결제승인 완료 노티(notifyUrl)는 영업담당자를 통해 오픈전 KICC에 알려주셔야 합니다.
• 승인결과의 결제금액과 상점의 결제금액이 상이할 시 반드시 취소처리 바랍니다.
• 승인결과에 대한 상점 DB 처리 실패 시 반드시 취소처리 바랍니다
• 노티결과 응답은 반드시 10초 이내에 회신해야 합니다.

결제결과 노티 방화벽

인바운드 트래픽에 대해 다음과 같이 상점 서버의 방화벽을 설정하시기 바랍니다.

구분	출발지 IP	설명
운영	203.233.72.66	INBOUND
개발	61.33.205.151	INBOUND

연동하기

HTTP Header

상점에서 아래 헤더 정보를 처리할 수 있도록 해야 합니다.

헤더 정보

POST https://{상점 결제승인 완료 노티 URL}
Content-type: application/json; charset=utf-8

HTTP Body

필드명	타입	길이	필수여부	설명
resCd	String	4Byte	✅	응답코드
resMsg	String	1000Byte	✅	응답메시지
mallId	String	8Byte		KICC에서 부여한 상점ID
shopOrderNo	String	40Byte		상점 주문번호
pgCno	String	20Byte		KICC 결제승인 거래고유번호
approvalDate	String	14Byte		결제승인 완료 시 전송하는 결제 승인일시(yyyyMMddHHmmss)
amountInfo	Object			결제금액 정보 (아래 amountInfo 참조)

amountInfo(결제금액 정보)

필드명	타입	길이	필수여부	설명
currency	String	2Byte	✅	통화코드
amount	Number		✅	결제금액

노티 응답처리

필드명	타입	길이	필수여부	설명
resCd	String	4Byte	✅	응답코드
resMsg	String	1000Byte	✅	응답메시지(상점에서 결제처리 실패 사유)
pgCno	String	20Byte	✅	KICC 결제 거래고유번호

노티 응답 예시

{  
    // 결과처리 성공했을 경우
    "resCd": "0000",
    "resMsg": "정상",
    "pgCno": "{KICC  결제 거래고유번호}"
    // 결과처리 실패했을 경우
    "resCd": "5001",
    "resMsg": "처리실패",
    "pgCno": "{KICC  결제 거래고유번호}"
}