Payout statuses (older versions)
This page describes the status transitions for payouts on API version 2023-10-01 or earlier.
Statuses for payout approvals:
| 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_APPROVAL* | The payout is submitted for approval. | payment.in_approval | Approvers can review the payout in the web app. |
| RECALLED* | The payout is recalled by a user in the web app. | payment.recalled | Users can edit and resubmit the payout in the web app. |
| REJECTED* | The payout is rejected by an approver in the web app. | payment.rejected | Users can edit and resubmit the payout in the web app. |
| BLOCKED* | Payout is blocked as next approver cannot be found | payment.blocked | Account owner or Admin users can edit the Transfers approval workflow and resubmit the payout in the web app. |
| PENDING_FUNDS* | Payout is waiting for funds to be available. | payment.pending_funds | 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. |
* These statuses are only applicable to the payouts that are created and submitted for approval.
You can subscribe to Payouts webhook events to receive the payout information in JSON payloads in case of any status transitions.