Check Transaction Status
Check Transaction Status
Use this endpoint to query the status of a transaction across all supported transaction types.
- URL: "/v3/merchant-host/transaction/check"
If Check Transaction Status API returns:
- If the Response Code is "Success", merchant can mark this transaction as successful.
- If the Response Code is "Failed", merchant can mark this transaction as failed.
- If the transaction is in a "Processing" status or there is no response, please retry the request at an incremental time range of every 5 seconds (e.g., 5 seconds, 10 seconds, 15 seconds, and so on) up to a maximum of 100 seconds. If there is no response after 100 seconds, please retry the request at an incremental time range of every 5 minutes up to 24 hours.
Request Parameters
request_idstringRequired
Unique identifier of the request, accepts up to 64 characters.
reference_idstringRequired
Unique identifier of the transaction merchant would like to query, which could be payment_reference_id, capture_reference_id or refund_reference_id.
transaction_typeuint32Required
Specific Transaction Types that merchant would like to query.
merchant_ext_idstringRequired
Unique identifier of merchant in merchant system.
store_ext_idstringRequired
Unique identifier of store in merchant system.
amountint64Required
This amount must match the original transaction amount.
Response Parameters
request_idstring
Unique identifier for request.
errcodeint32
Error code to specify the error returned.
debug_msgstring
Debug message to provide more information.
payment_methoduint32
Indicates the product flows used. Refer to Point of Initiation for the respective product flows.Note: do not set this as default value for validation
transactionobject
Will return empty if no such transaction.
co_fundingobject
Will return empty if no co-funding involved.
Note: This field is currently used in Thailand and Vietnam only.
Note: This field is currently used in Thailand and Vietnam only.
Response Code
| Value | Description |
|---|---|
| -2 | A server dropped the connection |
| -1 | A server error occurred |
| 0 | Success |
| 1 | The Request Parameters is invalid or a mandatory parameter is empty |
| 2 | Permission denied, often due to invalid status |
| 4 | Not found, often due to merchant/store/user/transaction not found |
| 5 | Transaction is in processing status |