Transaction states
Detailed description of the states that a transaction can hold.
Requests to the /transactions API fetch 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 state | Definition | Card | card-to-card | ACH | RDC |
|---|---|---|---|---|---|
failed | Transaction error based on network failure or a process timeout. | ✅ | ✅ | ||
declined | The account contained insufficient funds for the transaction or the transaction was denied based on other factors. | ✅ | ✅ | ||
pending | The transaction is pending a money movement and is currently being processed. | ✅ | ✅ | ✅ | |
completed | The transaction has finalized and funds have been debited or credited from the receiver account. | ✅ | ✅ | ✅ | ✅ |
returned | The 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
failedstate exists, the Transaction API or Webhook, will not transmit afailedtransaction.
Updated over 2 years ago