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 Name	Type	Length	Required	Description
tid	String	10Byte	✅	KICC Terminal ID
svcId	String	10Byte	✅	KICC Simple Payment Service ID
bizrNo	String	10Byte	✅	Merchant Business Registration Number
mercTrxNo	String	40Byte	✅	Merchant Transaction Number (20Byte recommended)
tokenKey	String	40Byte	✅	Simple Payment Token data (Same value used in Approval request)
alotMonth	String	2Byte	✅	Installment Period (Default: "00" - Lump-sum)
trxAmt	Number		✅	Total Payment Amount
vatAmt	Number		✅	VAT
svcAmt	Number		✅	Service Charge
tranDt	String	8Byte	✅	Merchant Transmission Date (yyyyMMdd)
tranTm	String	6Byte	✅	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 Name	Type	Length	Required	Description
respCd	String	4Byte	✅	Result Code (Success: “0000”)
respMsg	String	128Byte	✅	Result Message
tid	String	10Byte	✅	KICC Terminal ID
svcId	String	10Byte	✅	KICC Simple Payment Service ID
bizrNo	String	10Byte	✅	Merchant Business Registration Number
mercTrxNo	String	20Byte	✅	Merchant Transaction Number
trxDt	String	8Byte	✅	VAN Processing Request Date
trxTm	String	6Byte	✅	VAN Processing Request Time
cardConfirmNo	String	40Byte	✅	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"
}