Go to websitellms.txt

Payout statuses and failure codes reference

The statuses a payout moves through, the approval state, and the failure codes you may receive — each with a customer-safe meaning.

A payout has a status (where it is in processing) and, before it sends, an approval state. If it fails, you also get a failure code with a customer-safe message. These are what you’ll see on a payout and on payout notifications.

Statuses

StatusMeaning
PendingCreated, not yet sent — often waiting for approval or a review.
ProcessingApproved and sent; the bank is moving the money.
CompletedDone from our side.
FailedDidn’t send; the amount returns to the wallet.
CancelledCancelled before sending.

Approval state

Failure codes

CodeCustomer-safe message
bc_rejectedThe bank rejected the payout.
bc_missing_fundingThe payout could not be funded.
bc_reversedThe payout was reversed by the bank.
bc_payment_failedThe payout could not be processed.
compliance_hold / compliance_rejectedPaused for review — contact support.

Validation errors (before a payout is sent) are returned directly — for example an unsupported currency, an unapproved payout method, or insufficient balance. See Why did my payout fail?

Was this helpful?
Related
DevelopersPayment statuses referenceThe statuses a payment moves through, from created to settled, plus the refund and failure states — with what each one means for your integration.DevelopersHow do idempotency keys work?Send a unique idempotency key with a request so a retry can't create a duplicate. Reusing a key returns the original result instead of acting twice — essential for payouts.PayoutsWhy did my payout fail?A failed payout means the money didn't leave and is back in your balance. The usual causes are the bank rejecting it, a funding issue, or not enough available balance. Here's each one.
Book a demo