Transfer statuses (older versions)
This page describes transfer status transitions for legacy API versions. For the latest version, please see Transfer statuses.
API ver. 2024-01-31 to 2025-06-16
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. |
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 | 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 our banking partner's processing or was rejected by the recipient bank. 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. |
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 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.
API ver. 2023-10-01 and before
Transfer statuses
Statuses for transfer approvals:
Status | Description | Webhook Event Type | Next steps |
---|---|---|---|
NEW | You have successfully created the transfer 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 transfer is submitted for approval. | payment.in_approval | Approvers can review the transfer in the web app. |
RECALLED* | The transfer is recalled by a user in the web app. | payment.recalled | Users can edit and resubmit the transfer in the web app. |
REJECTED* | The transfer is rejected by an approver in the web app. | payment.rejected | Users can edit and resubmit the transfer in the web app. |
BLOCKED* | Transfer is blocked as next approver cannot be found | payment.blocked | Account owner or Admin users can edit the Transfers approval workflow and resubmit the transfer in the web app. |
PENDING_FUNDS* | Transfer is waiting for funds to be available. | payment.pending_funds | No action needed. |
IN_REVIEW | The transfer is on hold and being reviewed by Airwallex. We may request for additional information from you via email. Once the review is completed, the transfer will automatically transition to READY_FOR_DISPATCH . If the transfer 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 transfer 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 transfer has been dispatched from Airwallex and will remain in this status if successful. Note that transfers 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 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. | payment.failed | Before a failed transfer is automatically cancelled, you can either Retry APIor Cancel API it. See Handle failed transfers to determine the next step based on your failure reason. |
RETRIED | The failed transfer has been retried with updated details. The RETRIED status is the end state for the original transfer, and a new transfer is successfully created with the same request_id . See Retry a transfer. | payment.retried | Track the new transfer created. Corresponding fees may apply (see Fees in retries). |
CANCELLATION_REQUESTED | Transfer 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 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. | payment.cancelled | Corresponding fees may apply (see Fees in cancellations). |
SUSPENDED | The transfer 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 transfer to be automatically cancelled by Airwallex. |
* These statuses are only applicable to the transfers that are created and submitted for approval.
You can subscribe to Transfers webhook events to receive the transfer information in JSON payloads in case of any status transitions.