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 state | Definition | Card | Account to Account | ACH |
|---|---|---|---|---|
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. | ✅ | ✅ | |
cancelled | The transaction has been cancelled or voided. This may be due to the customer canceling the process. | ✅ | ||
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 about 2 years ago