Skip to main content

Cancellation Notification (Webhook)

You can receive the payment cancellation result at the notifyUrl specified during the cancellation request. 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 Cancellation Status API to verify the transaction status.
Critical Requirements
  • Registration: You must inform your KICC sales representative of your notifyUrl before launching the service.
  • 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.

EnvironmentSource IPDescription
Production203.233.72.66INBOUND
Development61.33.205.151INBOUND

Integration Guide​

HTTP Header​

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

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

HTTP Body (Incoming Request)​

Field NameTypeLengthRequiredDescription
resCdString4Byte✅Result Code (Success: "0000")
resMsgString1000Byte✅Result Message
mallIdString8ByteMerchant ID assigned by KICC
shopOrderNoString40ByteMerchant Order No.
pgCnoString20ByteOriginal Payment Transaction ID
cancelPgCnoString20ByteCancellation Transaction ID
cancelDateString14ByteCancellation Date/Time (yyyyMMddHHmmss)
amountInfoObjectCancellation Amount Info (See amountInfo below)

amountInfo (Cancellation Amount Info)​

Field NameTypeLengthRequiredDescription
currencyString2Byte✅Currency Code
amountNumber✅Cancellation Amount

Response Requirement (Ack)​

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

Field NameTypeLengthRequiredDescription
resCdString4Byte✅Response Code (Success: "0000")
resMsgString1000Byte✅Response Message (Failure reason if applicable)
pgCnoString20Byte✅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}"
}