Skip to main content

Net-Cancel

This API is used to ensure data integrity when a response for an approval request is not received due to communication failure or timeout. You must attempt a Net-Cancel using the exact same data from the original approval request.

🚨 Critical: Mandatory Scenarios for Net-Cancel

You MUST call the Net-Cancel API in the following situations:

  1. Read Timeout: When no response is received within the configured time (e.g., 30 seconds) after an approval request.
  2. Connection Error: When the connection is lost or a network error occurs during an approval request.
  3. Parsing Error: When a response is received, but the JSON format is corrupted, making it impossible to determine the success of the transaction.

Request​

Request URL
POST https://{API Domain}/smpy/kiccpay/reqRtran
Content-type: application/json; charset=utf-8

Parameters​

Field NameTypeLengthRequiredDescription
tidString10Byte✅KICC Terminal ID
svcIdString10Byte✅KICC Simple Payment Service ID
bizrNoString10Byte✅Merchant Business Registration Number
mercTrxNoString40Byte✅Merchant Transaction Number (20Byte recommended)
tokenKeyString40Byte✅Simple Payment Token data (Same value used in Approval request)
alotMonthString2Byte✅Installment Period (Default: "00" - Lump-sum)
trxAmtNumber✅Total Payment Amount
vatAmtNumber✅VAT
svcAmtNumber✅Service Charge
tranDtString8Byte✅Merchant Transmission Date (yyyyMMdd)
tranTmString6Byte✅Merchant Transmission Time (HH24MISS)
Request Example
{
"tid": "T123456789",
"svcId": "SVC_SIMPLE",
"bizrNo": "1234567890",
"mercTrxNo": "ORD_20231225_0001",
"tokenKey": "TOKEN_ABC123XYZ...",
"alotMonth": "00",
"trxAmt": 10000,
"vatAmt": 909,
"svcAmt": 0,
"tranDt": "20231225",
"tranTm": "120000"
}

Response​

Parameters​

Field NameTypeLengthRequiredDescription
respCdString4Byte✅Result Code (Success: “0000”)
respMsgString128Byte✅Result Message
tidString10Byte✅KICC Terminal ID
svcIdString10Byte✅KICC Simple Payment Service ID
bizrNoString10Byte✅Merchant Business Registration Number
mercTrxNoString20Byte✅Merchant Transaction Number
trxDtString8Byte✅VAN Processing Request Date
trxTmString6Byte✅VAN Processing Request Time
cardConfirmNoString40Byte✅Masked Card Number
Response Example
{
"respCd": "0000",
"respMsg": "Net-Cancel Success",
"tid": "T123456789",
"svcId": "SVC_SIMPLE",
"bizrNo": "1234567890",
"mercTrxNo": "ORD_20231225_0001",
"trxDt": "20231225",
"trxTm": "120005",
"cardConfirmNo": "1234-56**-****-1234"
}