Skip to content
For the complete documentation index, see llms.txt. This page is also available as Markdown.

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.

status
Final state?
Description

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.

A pending withdrawal already lowers the account balance. Treat completed and cancelled as final; pending and send_failed can still change.

Bank-side processing status

The bankWithdrawalTransactions object in included[] carries two further fields:

  • paymentStatus tracks the transfer on the bank side. The usual sequence is draft, created, validated, approved, processed, completed; on_hold (compliance review) and failed (rejected by the bank, then retried or cancelled) are detours, and cancelled is final. paymentStatus can lag behind simplifiedState, so use simplifiedState to drive your logic.

  • approvalStatus is the approval-workflow status for dashboard-initiated withdrawals subject to an approval rule. It is null for withdrawals created through the API. See the Approvals feature guide.

Last updated