📤💸 Withdraw Statuses

The status string indicates the current lifecycle state of a withdrawal. The following statuses are currently supported:

unsent – The withdrawal has been created but has not yet been submitted for processing.

sending – The withdrawal is currently being processed and submitted to the banking partner.

sent – The withdrawal has been successfully submitted.

error – An error occurred during processing. The withdrawal was not successfully completed and may require retry or manual intervention.

canceled – The withdrawal was intentionally cancelled before being successfully sent.

replaced – The withdrawal was superseded by a new one, created by our team to re-issue the same payout under a new withdrawal ID.

refunded – The withdrawal failed after funds were reserved or deducted, and the funds have been returned to the user.

replaced is not a failure. It means the payout was re-issued, not aborted, and it may still be completed under the new withdrawal ID. Do not refund your end user and do not create a replacement withdrawal on your side when you see it — that would pay twice. The new withdrawal ID is not returned by this endpoint today, so contact our team to have it linked.

Treat this list as open-ended. New statuses may be added as the product evolves, so send any value your integration does not recognize to manual review instead of treating it as a failure.