Important Terminologies

There are a few terminologies within Instant Transfers that you should familiarize yourself with below

Trigger Transfer (Disbursement) Status

After a transfer or disbursement is triggered, the system returns a latestTransactionStatus value that indicates the current transaction status. This value is included in both the API response and the callback.

The possible transaction statuses are as follows:

1. latestTransactionStatus: 00 - Success The funds have been successfully transferred to the beneficiary’s account.
2. latestTransactionStatus: 03 - Pending The transfer is still being processed.
   This status is temporary and may later change to Success (00) or Failed (06).
3. latestTransactionStatus: 04 - Refunded This is a rare status. It may occur when a transfer was previously marked as Success by the bank but was later reversed or bounced back.
4. latestTransactionStatus: 06 - Failed The transfer was not completed and the funds were not delivered to the beneficiary. In this case, the transfer may be retried if needed.
5. latestTransactionStatus: 07 - Not Found The referenced transfer cannot be found in the system. This usually indicates an invalid or unknown transaction reference.

To determine the final and authoritative status of a transaction, always refer to the latestTransactionStatus field. Do not determine the transaction status based solely on the HTTP response code.

Disbursement State Diagram

For rules on how to handle Pending, Failed, or abnormal statuses, refer to the Guidelines section in the API Flow page.