Skip to main content

Transaction Status Inquiry

This API is used to verify the status of a transaction when you fail to receive a response (e.g., due to timeout) during an approval or cancellation request.

Important Limitations
  • The Message Authentication Value (msgAuthValue) is NOT provided in the status inquiry response.
  • This service supports inquiries for transactions from the previous day to the current day only.

Request​

Request URL
POST https://{API Domain}/easypay/payment/tradeStatus.do
Content-type: application/json; charset=euc-kr

Parameters​

Field NameTypeLengthRequiredDescription
mallIdString8Byte✅Merchant ID assigned by KICC
shopTransactionIdString60Byte✅Merchant Transaction ID (API Idempotency Key)
transactionDateString8Byte✅Original Approval/Cancel Request Date (yyyyMMdd)
Request Example
{  
    "mallId": "{Merchant ID}", 
    "shopTransactionId": "{API Idempotency Key}",    
    "transactionDate": "{Request Date}"
}

Response​

The response structure varies depending on the transaction status. Please refer to the response parameters of the respective APIs.