Skip to main content

Transaction Status Check

This API checks the status of a transaction when no response was received (e.g., due to a timeout) during a Payment Approval or Cancellation request.

Important Constraints
  • Message Authentication Value (msgAuthValue) is not provided in the response of this API.
  • This service only supports querying transactions from yesterday and today.

Request​

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

Parameters​

Field NameTypeLengthRequiredDescription
mallIdString8Byte✅Merchant ID assigned by KICC
shopTransactionIdString60Byte✅Merchant Transaction ID used in the original Approval/Cancel request
transactionDateString8Byte✅Original Request Date (yyyyMMdd)
Request Example
{  
    "mallId": "{Merchant ID}", 
    "shopTransactionId": "{Merchant Transaction ID}", 
    "transactionDate": "{Original Request Date}"
}

Response​

The response format depends on the status of the transaction. Please refer to the corresponding response definitions below: