Transfer statuses
This page describes the status transitions for transfers (including approvals and funding) for API version 2025-06-30 or later. For older API versions, please see transfer statuses (older versions).
Transfer statuses
Transfer statuses in transfer approvals flow:
Transfer Status | Description | Webhook Event Type | Next steps |
---|---|---|---|
IN_APPROVAL* | The transfer is submitted and waiting for approval. | payout.transfer.in_approval | Approvers can review the transfer in the web app. |
APPROVAL_RECALLED* | The transfer is recalled by a user in the web app. | payout.transfer.approval_recalled | Users can edit and resubmit the transfer in the web app. |
APPROVAL_REJECTED* | The transfer is rejected by an approver in the web app. | payout.transfer.approval_rejected | Users can edit and resubmit the transfer in the web app. |
APPROVAL_BLOCKED* | Transfer is blocked as next approver cannot be found. | payout.transfer.approval_blocked | Account owner or Admin users can edit the Transfers approval workflow and resubmit the transfer in the web app. |
SCHEDULED | The transfer is scheduled to be processed on the transfer date. | payout.transfer.scheduled | You may need to provide additional information requested by Airwallex as part of the transaction risk assessment. See Request for Information (RFI) for more details. |
OVERDUE | The transfer has not been funded on or after the scheduled transfer date. | payout.transfer.overdue | Retrieve funding statuses for further details. Pre-funded transfers that are not fully funded by the end of the transfer date will be automatically cancelled. |
PROCESSING | The transfer is being processed. If it is successfully funded and passes review by Airwallex, transfer status will automatically transition to SENT , otherwise its status will transition to FAILED if it cannot be processed. | payout.transfer.processing | You may need to provide additional information requested by Airwallex as part of the transaction risk assessment. See Request for Information (RFI) for more details. |
SENT | The transfer has been sent from Airwallex. Note that the transfer may subsequently fail our banking partners’ processing, at which point its status will transition to FAILED . | payout.transfer.sent | You may need to provide additional information requested by Airwallex's banking partners. See Request for Information (RFI) for more details. |
PAID | The transfer has been processed successfully by our banking partner. Note that the transfer may subsequently fail if it is rejected by the local clearing system or the recipient bank, at which point its status will transition to FAILED . | payout.transfer.paid | No action needed. |
FAILED | The transfer has failed to be processed. Failed transfers will be automatically cancelled in seconds. | payout.transfer.failed | See Handle failed transfers to determine the next step based on your failure reason. |
CANCELLED | The transfer has been successfully cancelled. The paid amount (less any applicable fees) will be returned to the Wallet. See Cancel a transfer for further details. | payout.transfer.cancelled | Corresponding fees may apply (see Refund and Fees). |
* These statuses are only applicable to transfers that are created and submitted for approval.
Funding statuses
Funding statuses provide details on the funding of a transfer and can be retrieved from the funding object within the response of Transfer API endpoints API. For example, when a transfer 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 transfer requires your confirmation. | payout.transfer.funding.requires_funding_confirmation | For transfers that are created and submitted for approval, the funding will be confirmed once approved. For transfers under manual-funding mode, call Confirm funding for a transfer API to trigger fund deduction on transfer date. See Fund deduction for further details. |
SCHEDULED | The funding is scheduled to be processed on the transfer date. | payout.transfer.funding.scheduled | Ensure sufficient balance is available in the Airwallex Wallet or Linked Account to cover the transfer amount (including fees). |
PROCESSING | The funding for this transfer is being processed. | payout.transfer.funding.processing | For transfers funded by Wallet, please ensure there is sufficient balance if status remains at PROCESSING . |
FUNDED | This transfer has been successfully funded. | payout.transfer.funding.funded | No action needed. |
FAILED | This transfer failed to be funded. | payout.transfer.funding.failed | See failure reason for details and next step recommendations. |
CANCELLED | The funding for this transfer has been cancelled. | payout.transfer.funding.cancelled | No action needed. |
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 to REVERSED , and the corresponding amount will be deducted from your Wallet balance. | payout.transfer.funding.reversed | No action needed. |
** These statuses are only applicable to transfers funded via direct debits from Linked Accounts.
You can subscribe to Transfers webhook events to receive the transfer information in JSON payloads in case of any status transitions.