This page outlines the various states a transaction can move through during its lifecycle, with the
corresponding Event that appears in API payloads.
To follow the entire movement of funds from a payer to a payee, you will need to monitor both the main transaction states
and the payout states outlined below.
Main Transaction States
The main transaction states represent the key stages in a transaction’s lifecycle—from the initial debit of funds
from the payer to the final payout to the payee. These states are reflected on the transaction record and indicate the
progression of funds, starting with the capture phase and concluding when the transaction enters the payout (credit)
phase.
Transactions created via the API that pass initial validation will return a status of QUEUED, indicating they have
been accepted and are pending asynchronous processing. To learn more about how queueing works and what to expect,
see Transaction Queues. Capture Status States
In our webhooks and API responses, the capture status field indicates the current state of the capture phase of a
transaction. This phase involves debiting funds from the payor and depositing them into the FBO account. The capture status
provides insights into the progress of this process, from initiation to completion or failure.
Payout States (Credit to Payee)
The payout states represent the stages involved in crediting funds to the payee after a successful capture of funds from
the payor. These states indicate the progress of the payout process, starting from the initiation of the payout to its
completion or failure.
ACH Payouts
The following states occur during the payout phase of a transaction, when funds are being sent to the payee. The
states below are relevant to payouts created using the ACH payment rail.
FedNow Payouts
The following states occur during the payout phase of a transaction, when funds are being sent to the payee. The
states below are relevant to payouts created using the FedNow payment rail.
Sub-Operations
A successful transaction only involves the capture and payout phases. The following additional flows occur in
edge cases such as errors or refunds.
Reverse Payout States
These occur when a payout fails and funds need to be returned to the payer.
Clawback
A clawback is initiated if the debit from the payor is reversed after funds were already sent to the payee.
Refund
Refunds are initiated post-transaction to return funds to the original payer via the
Refund a Transaction API.
