Transaction lifecycle

Overview

Understanding the lifecycle of a transaction is just as important as knowing that a transaction has actually occurred. Whatever your role, it can be critical to know the exact state a transaction is in or the states it has been through. Bond provides full status and details of a transaction at every stage of its lifecycle. This transaction history is accessed using the Transaction history API.

Transaction state lifecycle

Bond transactions typically have the following states across all payment types, with the exception of card-to-card transactions that can only have a complete state.

Transaction states

The states of a transaction and their descriptions are shown in the table below.

State	Description
`start`	A transaction starts from a card swipe, online purchase, a check scan, or an ACH transfer.
`failed`/`declined`	If there are network issues, it is possible for a transaction to fail. Declined transactions are usually caused by insufficient funds, use of a frozen account, or if there are limitations on the merchant categories for using the card.
`pending`	While a transaction is being processed it is placed in a pending state.
`completed`	Once a transaction is posted, it is in the completed state.
`returned`	Transactions may be returned or reversed once they have been completed. For example, this can occur when merchandise is returned or if a chargeback occurs.

For more details, see Transaction states.

Transaction state example

In the response to a transaction history request, you might see multiple states for the same transaction. An example of this is shown below.

{
    "page": 1,
    "pages": 1,
    "count": 2,
    "transactions": [
        {
            "transaction_id": "94ab1902-2406-4894-99cf-9888e62e1288",
            "bond_brand_id": "123456abcdef",
            "customer_id": "1234567abcdef",
            "account_id": "12345678abcdef",
            "payment_type": "card",
            "transaction_type": "00",
            "state": "Approved",
            "amount": "-2.00",
            "currency": "USD",
            "created_time": "2021-03-16T16:17:39.578198+00:00",
            "updated_time": "2021-03-17T00:53:11",
            "balances": {
                "new_balance": "23.00"
            },
            "details": {
                "card_id": "abcdef1234567890",
                "mcc": "5942",
                "mcc_description": "Book Stores",
                "currency": "USD",
                "merchant_id": "",
                "merchant_name": "Amazon.com*4D08H4AP3     Amzn.com/billWAUSA",
                "merchant_city": "Amzn.com/bill",
                "merchant_state": "WA",
              	"merchant_postal_code": "34100",
                "merchant_currency": "USD",
                "merchant_amount": "-2.00",
                "exchange_rate": "1.00",
              	"cardholder_presence": false,
                "statement_descriptor": "Pre-Auth Transaction-POS Signature Purchase"
            }
        },
        {
            "transaction_id": "94ab1902-2406-4894-99cf-9888e62e1288",
            "bond_brand_id": "123456abcdef",
            "customer_id": "1234567abcdef",
            "account_id": "12345678abcdef",
            "payment_type": "card",
            "transaction_type": "POS Purchase",
            "state": "Pending",
            "amount": "-2.00",
            "currency": "USD",
            "created_time": "2021-03-16T16:17:39.578198+00:00",
            "updated_time": "2021-03-16T16:16:57",
            "balances": {
                "new_balance": "23.00"
            },
            "details": {
                "card_id": "abcdef1234567890",
                "mcc": "5942",
                "mcc_description": "Book Stores",
                "currency": "USD",
                "merchant_id": "784959000762203",
                "merchant_name": "Amazon.com               Amzn.com/billWAUSA",
                "merchant_city": "Amzn.com/bill",
                "merchant_state": "WA",
                "merchant_postal_code": "34100",
                "merchant_currency": "USD",
                "merchant_amount": "-2.00",
                "exchange_rate": "1.00",
              	"cardholder_presence": false,
                "statement_descriptor": "Pre-Auth Transaction-POS Signature Purchase"
            }
        }
    ]
}