Payment Approval Notification (Webhook)

You can receive the payment approval result at the notifyUrl specified during transaction creation. Your server must be implemented to handle this notification as described below.

Retry Policy & Fallback

• Retry Policy: For WeChat Pay, if a success response is not received, the notification is resent up to 15 times.
• Fallback: If you do not receive a notification for a certain period, please use the Check Payment Status API to verify the transaction status.

Critical Requirements

• Registration: You must inform your KICC sales representative of your notifyUrl before launching the service.
• Integrity Check: If the amount in the notification differs from your internal order amount, you MUST cancel the transaction immediately.
• DB Failure: If you fail to update your database after receiving the notification, you MUST cancel the transaction.
• Timeout: Your server must respond to the notification within 10 seconds.

Firewall Settings

Please configure your server's firewall to allow inbound traffic from the following IPs.

Environment	Source IP	Description
Production	203.233.72.66	INBOUND
Development	61.33.205.151	INBOUND

Integration Guide

HTTP Header

The notification is sent as a POST request with the following header.

Header Info

POST https://{Your notifyUrl}
Content-type: application/json; charset=utf-8

HTTP Body (Incoming Request)

Field Name	Type	Length	Required	Description
resCd	String	4Byte	✅	Result Code (Success: "0000")
resMsg	String	1000Byte	✅	Result Message
mallId	String	8Byte		Merchant ID assigned by KICC
shopOrderNo	String	40Byte		Merchant Order No.
pgCno	String	20Byte		KICC Payment Transaction ID
approvalDate	String	14Byte		Payment Approval Date/Time (yyyyMMddHHmmss)
amountInfo	Object			Payment Amount Info (See amountInfo below)

amountInfo (Payment Amount Info)

Field Name	Type	Length	Required	Description
currency	String	2Byte	✅	Currency Code
amount	Number		✅	Payment Amount

Response Requirement (Ack)

Your server must respond with a JSON object containing the result of your internal processing.

Field Name	Type	Length	Required	Description
resCd	String	4Byte	✅	Response Code (Success: "0000")
resMsg	String	1000Byte	✅	Response Message (Failure reason if applicable)
pgCno	String	20Byte	✅	KICC Payment Transaction ID (Echo back the received value)

Response Example

{  
    // If processed successfully
    "resCd": "0000",
    "resMsg": "Success",
    "pgCno": "{KICC Payment Transaction ID}"

    // If internal processing failed
    "resCd": "5001",
    "resMsg": "Internal DB Error",
    "pgCno": "{KICC Payment Transaction ID}"
}