Delete Billing Key

This API is used to delete a previously issued Billing Key when it is no longer in use.

Request

Request URL

POST https://{API Domain}/api/trades/removeBatchKey
Content-type: application/json; charset=utf-8

Note

Supports API Idempotency (See API Idempotency)

Parameters

Field Name	Type	Length	Required	Description
mallId	String	8Byte	✅	Merchant ID assigned by KICC
shopTransactionId	String	60Byte	✅	Merchant Transaction ID (API Idempotency Key)
batchKey	String	40Byte	✅	Billing Key to delete
removeReqDate	String	8Byte	✅	Deletion Request Date (yyyyMMdd)

Request Example

{  
    "mallId": "T5102001",     
    "shopTransactionId": "{API Idempotency Key}",    
    "batchKey": "{Billing Key to delete}",
    "removeReqDate": "{Deletion Request Date}"
}

Response

Parameters

Field Name	Type	Length	Required	Description
resCd	String	4Byte	✅	Response Code (Success: “0000”)
resMsg	String	1000Byte	✅	Response Message
shopTransactionId	String	60Byte	✅	Returns the same value sent in the request
mallId	String	8Byte		Merchant ID assigned by KICC
removeReqDate	String	8Byte		Returns the same value sent in the request

Response Example

{
   "resCd": "0000",
   "resMsg": "Success",
   "mallId": "{Requested Merchant ID}",   
   "shopTransactionId": "{Requested API Idempotency Key}",
   "removeReqDate": "{Deletion Request Date}"
}