Transfer statuses
This page describes the status transitions for transfers (including approvals and funding) for API version 2024-01-31 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 if it is funded and passes review by Airwallex. | payout.transfer.scheduled | No action needed. |
| OVERDUE | The transfer is not funded beyond the transfer date. | payout.transfer.overdue | Retrieve funding statuses for further details. Funding status of an OVERDUE transfer can be REQUIRES_FUNDING_CONFIRMATION/PROCESSING/FAILED. |
| PROCESSING | The transfer is funded and being processed. Transfer status will automatically transition to SENT when the transfer is successfully sent to our banking partners, otherwise its status will transition to FAILED if it cannot be processed. | payout.transfer.processing | No action needed. |
| 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 | No action needed. |
| 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 our banking partner's processing or was rejected by the recipient bank. Failed transfers 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. | payout.transfer.failed | Before a failed transfer is automatically cancelled, you may Cancel API the transfer. See Handle failed transfers to determine the next step based on your failure reason. |
| CANCELLATION_REQUESTED | Transfer cancellation has been requested before SENT, and will transition to CANCELLED when transfer is successfully refunded. | payout.transfer.cancellation_requested | No action needed. |
| CANCELLED | The transfer has been successfully cancelled. The transfer 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.
** This status is only applicable to API version 2024-04-30 or after.
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 under manual-funding mode. See Fund deduction for further details. | payout.transfer.funding.requires_funding_confirmation | Call Confirm funding for a transfer API to trigger fund deduction on transfer date. |
| 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 is successfully funded. | payout.transfer.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. | payout.transfer.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. | 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.