Transaction states

Detailed description of the states that a transaction can hold.

Requests to the /transactions can API retrieve all transaction types, including card-to-card, ACH, and account transactions. Bond's simplified set of transaction states is compatible across all vendors.

The table below lists transaction states and shows the types of transactions that return these states.

Transaction stateDefinitionCardcard-to-cardACHRDC
failedTransaction error based on network failure or a process timeout.
declinedThe account contained insufficient funds for the transaction or the transaction was denied based on other factors.
pendingThe transaction is pending a money movement and is currently being processed.
cancelledThe transaction has been cancelled or voided. This may be due to the customer canceling the process.
completedThe transaction has finalized and funds have been debited or credited from the receiver account.
returnedThe transaction has been reversed, either by the customer or by the bank.

📘

Transaction failure states

When a card transaction fails, the network provides a failed response to the POS system, the eCommerce platform, or even the ATM. These failures are generally caused by network instabilities, which never result in the card processor registering a failed transaction. Therefore, even though a failed state exists, the Transaction API or Webhook, will not transmit a failed transaction.


Next Steps