Bank withdrawal status flow
A bank withdrawal sends fiat from one of your accounts to a bank account registered with Txn. Its status is the simplifiedState attribute returned by Listing bank withdrawals, Reading bank withdrawal and Listing transactions.
pending
no
Withdrawal accepted. The amount is reserved from the account balance while the transfer is prepared and sent.
send_failed
no
The transfer to the bank failed. Txn retries it or cancels the withdrawal.
completed
yes
Transfer sent and settled. The amount is debited from the account.
cancelled
yes
Withdrawal cancelled before completion. The reserved amount is released back to the account balance.
Bank-side processing status
The bankWithdrawalTransactions object in included[] carries two further fields:
paymentStatustracks the transfer on the bank side. The usual sequence isdraft,created,validated,approved,processed,completed;on_hold(compliance review) andfailed(rejected by the bank, then retried or cancelled) are detours, andcancelledis final.paymentStatuscan lag behindsimplifiedState, so usesimplifiedStateto drive your logic.approvalStatusis the approval-workflow status for dashboard-initiated withdrawals subject to an approval rule. It isnullfor withdrawals created through the API. See the Approvals feature guide.
Last updated