Transaction Lifecycle

Overview of the 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.

cancelled

A user may try to cancel a transaction when it's in the pending state. This my be due to a product being on back order or a ACH transfer not being correctly defined.

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"
            }
        }
    ]
}

Did this page help you?