Guides

Status Inquiry API

Status Inquiry API is used to retrieve the latest status of a transfer or disbursement transaction.

The Trigger Transfer API processes transactions asynchronously, which means the final transaction result may not be available immediately in the initial response. Under normal conditions, the final status will be delivered through callback. If the callback is delayed, not received, or the transaction status needs to be rechecked manually, the Status Inquiry API may be used to retrieve the latest transaction status synchronously.

This API only returns the latest transaction status and does not trigger a callback. HTTP 4xx or 5xx responses from the Status Inquiry API do not automatically mean that the original transfer has failed.


Important Notes

  • Always use the latestTransactionStatus returned in the callback or in the Status Inquiry API response to determine the actual transaction outcome.
  • Do not determine the transaction outcome based only on the HTTP response code, response message, or error message from the initial Trigger Transfer request.
  • Do not mark the original transaction as failed only because the Status Inquiry API returns an HTTP 4xx or 5xx response. In such cases, the inquiry request may have failed due to request validation issues or temporary system issues, while the original transfer may still be processing or may already have reached a final state.
  • If the Status Inquiry API does not return a valid latestTransactionStatus, the original transaction status should remain unchanged. Continue waiting for the callback or retry the Status Inquiry later.
  • If the initial Trigger Transfer request returns an HTTP 5xx response, do not call the Status Inquiry API immediately. The transaction may still be processing in the backend system. Wait at least 15 minutes before checking the transaction status using the Status Inquiry API, unless the callback is received earlier.
  • The Status Inquiry API should be used only when needed, such as when:
    • the callback is delayed or not received, or
    • manual status verification is required.

Transaction Status Guide

The transaction must be handled based on the returned latestTransactionStatus value as follows:

  • 00 → Success
  • 03 → Pending / Processing
  • 04 → Refunded
  • 05 → Canceled
  • 06 → Failed
  • 07 → Not Found

If the returned status is still 03 (Pending / Processing), the transaction should remain pending until a final status is received through callback or a later Status Inquiry response.


Handling Behavior

  1. Submit the transfer using the Trigger Transfer API.
  2. Wait for the callback to receive the final status.
  3. If the callback is delayed or not received, call the Status Inquiry API to retrieve the latest transaction status.
  4. If the initial Trigger Transfer request returned an HTTP 5xx response, wait at least 15 minutes before calling the Status Inquiry API.
  5. Update the transaction status only based on the returned latestTransactionStatus.