Payout statuses
This page describes the status transitions for payouts.
| Status | Description | Webhook Event Type | Next steps |
|---|---|---|---|
| NEW | You have successfully created the payout to be processed by Airwallex. If the transaction is scheduled for a future date, it will remain in this status until that date. | payment.new | No action needed. |
| IN_REVIEW | The payout is on hold and being reviewed by Airwallex. We may request for additional information from you via email. Once the review is completed, the payout will automatically transition to READY_FOR_DISPATCH. If the payout cannot be processed after the review, its status will transition to SUSPENDED. | payment.in_review | No action needed unless Airwallex requests for additional information. |
| READY_FOR_DISPATCH | The payout is ready for dispatch and will typically remain in this status if it is past the cut-off time of our downstream partner. | payment.ready_for_dispatch | No action needed. |
| DISPATCHED | The payout has been dispatched from Airwallex and will remain in this status if successful. Note that payouts may subsequently fail our banking partners’ processing or be rejected by the recipient bank, at which point its status will transition to FAILED. | payment.dispatched | No action needed. |
| FAILED | The payout has failed our banking partner's processing or was rejected by the recipient bank. Failed payouts will be automatically cancelled after a certain time depending on the region you are in. Please reach out to your Account Manager to find out more. | payment.failed | Before a failed payout is automatically cancelled, you can either Retry APIor Cancel API it. See Handle failed payouts to determine the next step based on your failure reason. |
| RETRIED | The failed payout has been retried with updated details. The RETRIED status is the end state for the original payout, and a new payout is successfully created with the same request_id. See Retry a payout. | payment.retried | Track the new payout created. Corresponding fees may apply (see Fees in retries). |
| CANCELLATION_REQUESTED | Payout cancellation has been requested before DISPATCHED, and will transition to CANCELLED when the currency conversion (if any) is settled. | payment.cancellation_requested | No action needed. |
| CANCELLED | The payout has been successfully cancelled. The payout amount (less any applicable fees) will be returned to the Wallet. See Cancel a payout for further details. | payment.cancelled | Corresponding fees may apply (see Fees in cancellations). |
| SUSPENDED | The payout has been suspended after being reviewed by Airwallex. It will be cancelled by us usually within a week, at which point its status will transition to CANCELLED. | payment.suspended | Expect the payout to be automatically cancelled by Airwallex. |
You can subscribe to Payouts webhook events to receive the payout information in JSON payloads in case of any status transitions.