Understand payment statuses and funding statuses
A Pay In transaction carries two separate statuses that answer two different questions:
- Payment status (
TransStatus) answers “did the transaction succeed?” - Funding status (
SettlementStatus) answers “where’s the money?”
Since each status resolves on its own timeline, they often show different things at the same moment. That’s expected, and it’s worth knowing how to read it before it looks like an error.
Two different questions, two different statuses
Payment status resolves fast. In a standard sale, a card charge or ACH debit moves from Initiated through Authorized to Approved/Captured within seconds, so catching a transaction at Initiated is rare. Some integrations authorize and capture separately instead, and in that flow a transaction can stay Authorized for up to 10 days before it’s captured or voided. Either way, after a transaction is captured, its payment status becomes Approved/Captured and won’t change again except for a rare rejection by the bank or card network after the fact. Funding status keeps moving from there. It follows the transaction into a batch, tracks that batch through settlement, and only reaches Funded once the money lands in the merchant’s bank account. That typically takes several days.
That gap between the two timelines is the source of most confusion. A transaction can sit at a finished payment status for days while its funding status keeps changing underneath it.
Payment funding status is a transaction-level view of the process. After a transaction is captured, it belongs to a batch, and the batch itself is tracked with its own BatchStatus and TransferStatus values, which generally move in step with the transaction’s funding status. See Batches overview to check or troubleshoot at the batch level — useful when several transactions are affected at once, like a batch placed on hold.
Reading a status combination
Most combinations of payment status and funding status are normal — they just reflect where a transaction is in its timeline. A smaller set signals an actual problem.
Visualizing the flow
This diagram lays out that same progression visually: payment status resolving quickly at the top, funding status continuing on its own timeline underneath.
Select a step to see what it means.
Payment succeeded and generally won't change again — a bank or card network rejection afterward is rare. Funding status keeps moving from here.
Payment and funding status flow
Payment status moves from Payment Initiated to Authorized to Approved/Captured. Capture happens within seconds, or after up to 10 days if the integration authorizes and captures separately. Payment status stays at Approved/Captured after that.
Funding status starts at Pending once the transaction is captured, moves to In Transit once the batch closes, then to Transferred once the transfer instruction is submitted, and finally to Funded once the funds have been sent.
This diagram shows only the successful path: a transaction that authorizes, captures, and funds without interruption. A transaction that’s declined, voided, failed, or blocked before capture never enters the funding side at all. A captured transaction can still end up with a Chargeback, ACH Return, or Exception funding status, or be refunded, instead of continuing on to Funded. The following table covers those outcomes.
Status combination reference
This table lists the common combinations and what they mean, and where a mismatch needs your attention:
For the full list of values behind each status, see Pay In statuses. Funding status also determines whether you can void or refund a transaction — see the Decision guide: Void vs refund.
An Exception, ACH Return, Chargeback, or Held funding status doesn’t change the payment status. The transaction stays Approved/Captured because the payment itself succeeded — the problem is downstream, in moving the money.
For a step-by-step walkthrough of how a transaction moves through these statuses, including diagrams of each stage, see Pay in transaction lifecycle.
Where to check each status
In the Payabli Portal, the transactions report shows both as separate columns: Payment Status and Payment Funding Status. Filter or sort on either independently. See the Transactions report for how to filter.
Through the Query API, both fields are returned on the same transaction record: TransStatus for payment status and SettlementStatus for funding status.
Related resources
See these related resources to help you get the most out of Payabli.
Prerequisites
- Pay in transaction lifecycle - Understand the full transaction lifecycle before comparing payment status and funding status
References
- Pay In statuses - Learn about Pay In (money in) statuses
- Decision guide: Void vs refund - Use this guide to help you choose between voiding or refunding a Pay In transaction