Skip to main content

Query Transaction Status

This API is used to verify the status of a specific transaction when a response was not received for an approval or cancellation request.

Important Note

The status inquiry service only supports same-day transactions.

Request​

Request URL
POST https://{API Domain}/appcardpay/v1/history.do
Content-type: application/json; charset=euc-kr

Parameters​

Field NameTypeLengthRequiredDescription
vanTidString8Byte✅VAN Terminal ID used for the original approval or cancellation request
shopTransactionIdString60Byte✅Merchant Transaction ID used during the original approval/cancellation request
reqDateString8Byte✅Original request date (yyyyMMdd)
Request Example
{  
    "vanTid": "{VAN Terminal ID}", 
    "shopTransactionId": "{Merchant Transaction ID}", 
    "reqDate": "{Request Date}"
}

Response​

Response for querying a successful payment approval.

Response Example
{  
  "resCd": "0000",
  "resMsg": "Payment Success",
  "vanTid": "{Requested Merchant ID}",
  "pgCno": "{PG Transaction ID}",
  "shopTransactionId": "{Requested API Idempotency Key}",
  "shopOrderNo": "{Merchant Order Number}",
  "amount": 51004,
  "transactionDate": "20210326090200",
  "accepterId": "{Member Store ID}",
  "cardCode": "029",   
  "paymentInfo": {
     "payMethodTypeCode": "11",
     "approvalNo": "00017177",
     "vanSerial": "50123011010326090200",
     "cardInfo": {
        "cardNo": "45184211******81",
        "issuerCode": "029",         
        "acquirerCode": "029",         
        "installmentMonth": "00"         
    }
  }
}