Payout statuses
This page describes the status transitions for payouts (including approvals and funding) for API version 2024-01-31 or later. For older API versions, please see payout statuses (older versions).
Payout statuses
Payout statuses in payout approvals flow:
Payout Status | Description | Webhook Event Type | Next steps |
---|---|---|---|
IN_APPROVAL* | The payout is submitted and waiting for approval. | payment.in_approval | Approvers can review the payout in the web app. |
APPROVAL_RECALLED* | The payout is recalled by a user in the web app. | payment.approval_recalled | Users can edit and resubmit the payout in the web app. |
APPROVAL_REJECTED* | The payout is rejected by an approver in the web app. | payment.approval_rejected | Users can edit and resubmit the payout in the web app. |
APPROVAL_BLOCKED* | Payout is blocked as next approver cannot be found. | payment.approval_blocked | Account owner or Admin users can edit the Transfers approval workflow and resubmit the payout in the web app. |
SCHEDULED | The payout is scheduled to be processed on the payout date if it is funded and passes review by Airwallex. | payment.scheduled | No action needed. |
OVERDUE | The payout is not funded beyond the payment date. | payment.overdue | Retrieve funding statuses for further details. Funding status of an OVERDUE payout can be REQUIRES_FUNDING_CONFIRMATION /PROCESSING /FAILED . |
PROCESSING | The payout is funded and being processed. Payout status will automatically transition to SENT when the payout is successfully sent to our banking partners, otherwise its status will transition to FAILED if it cannot be processed. | payment.processing | No action needed. |
SENT | The payout has been sent 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.sent | 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 may Cancel API the payout. See Handle failed payouts to determine the next step based on your failure reason. |
CANCELLATION_REQUESTED | Payout cancellation has been requested before SENT , and will transition to CANCELLED when payout is successfully refunded. | 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 Refund and Fees). |
* These statuses are only applicable to payouts that are created and submitted for approval.
Funding statuses
Funding statuses provide details on the funding of a payout and can be retrieved from the funding object within the response of Payout API endpoints API. For example, when a payout is OVERDUE
, funding statuses will be helpful to understand the reason and next steps.
Funding Status | Description | Webhook Event Type | Next steps |
---|---|---|---|
REQUIRES_FUNDING_CONFIRMATION | The funding of this payout requires your confirmation under manual-funding mode. See Fund deduction for further details. | payment.funding.requires_funding_confirmation | Call Confirm funding for a payment API to trigger fund deduction on payout date. |
SCHEDULED | The funding is scheduled to be processed on the payout date. | payment.funding.scheduled | Ensure sufficient balance is available in the Airwallex Wallet or Linked Account to cover the payout amount (including fees). |
PROCESSING | The funding for this payout is being processed. | payment.funding.processing | For payouts funded by Wallet, please ensure there is sufficient balance if status remains at PROCESSING . |
FUNDED | This payout is successfully funded. | payment.funding.funded | No action needed. |
FAILED** | Deposit via direct debit from a Linked Account is rejected as it failed validation by either Airwallex or the banking scheme. The funds will be returned to your external bank account. | payment.funding.failed | See failure reason for details and next step recommendations. |
REVERSED** | If the external bank recalls the deposit via direct debit from a Linked Account after it has been settled into your Wallet, the status of the funding will be updated from to REVERSED , and the corresponding amount will be deducted from your Wallet balance. | payment.funding.reversed | No action needed. |
** These statuses are only applicable to payouts funded via direct debits from Linked Accounts.
You can subscribe to Payouts webhook events to receive the payout information in JSON payloads in case of any status transitions.