Search...
APIJSLog inGet started
Airwallex logo
Home
Platform APIs
Connected Accounts
Accounts
Payments
Transactional FX
Payouts
Issuing
Back to home
OverviewHow Airwallex Payouts work
Payout network
Use cases
Older API versions
Transfers
Transfer statuses (older versions)
Handle failed transfers (older versions)Transfer webhooks (older versions)Error codes (older versions)
Batch transfers
Wallet transfers (Legacy)

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 status 2024-09-27

Transfer statuses in transfer approvals flow:

Transfer approval 2024-09-27

Transfer StatusDescriptionWebhook Event TypeNext steps
IN_APPROVAL*The transfer is submitted and waiting for approval.payout.transfer.in_approvalApprovers can review the transfer in the web app.
APPROVAL_RECALLED*The transfer is recalled by a user in the web app.payout.transfer.approval_recalledUsers 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_rejectedUsers can edit and resubmit the transfer in the web app.
APPROVAL_BLOCKED*Transfer is blocked as next approver cannot be found.payout.transfer.approval_blockedAccount owner or Admin users can edit the Transfers approval workflow and resubmit the transfer in the web app.
SCHEDULEDThe transfer is scheduled to be processed on the transfer date if it is funded and passes review by Airwallex.payout.transfer.scheduledNo action needed.
OVERDUEThe transfer is not funded beyond the transfer date.payout.transfer.overdueRetrieve funding statuses for further details.
PROCESSINGThe 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.processingYou may need to provide additional information requested by Airwallex as part of the transaction risk assessment. See Request for Information (RFI) for more details.
SENTThe 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.sentYou 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.paidNo action needed.
FAILEDThe 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.failedSee Handle failed transfers to determine the next step based on your failure reason.
CANCELLATION_REQUESTEDTransfer cancellation has been requested before SENT, and will transition to CANCELLED when transfer is successfully refunded.payout.transfer.cancellation_requestedNo action needed.
CANCELLEDThe 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.cancelledCorresponding 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 Statuses 2024-01-31

Funding StatusDescriptionWebhook Event TypeNext steps
REQUIRES_FUNDING_CONFIRMATIONThe funding of this transfer requires your confirmation under manual-funding mode. See Fund deduction for further details.payout.transfer.funding.requires_funding_confirmationCall Confirm funding for a transfer API to trigger fund deduction on transfer date.
SCHEDULEDThe funding is scheduled to be processed on the transfer date.payout.transfer.funding.scheduledEnsure sufficient balance is available in the Airwallex Wallet or Linked Account to cover the transfer amount (including fees).
PROCESSINGThe funding for this transfer is being processed.payout.transfer.funding.processingFor transfers funded by Wallet, please ensure there is sufficient balance if status remains at PROCESSING.
FUNDEDThis transfer is successfully funded.payout.transfer.funding.fundedNo 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.failedSee 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.reversedNo 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

transfer statuses 2023

Statuses for transfer approvals:

transfer approval 2023 new style

StatusDescriptionWebhook Event TypeNext steps
NEWYou 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.newNo action needed.
IN_APPROVAL*The transfer is submitted for approval.payment.in_approvalApprovers can review the transfer in the web app.
RECALLED*The transfer is recalled by a user in the web app.payment.recalledUsers can edit and resubmit the transfer in the web app.
REJECTED*The transfer is rejected by an approver in the web app.payment.rejectedUsers can edit and resubmit the transfer in the web app.
BLOCKED*Transfer is blocked as next approver cannot be foundpayment.blockedAccount 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_fundsNo action needed.
IN_REVIEWThe 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_reviewNo action needed unless Airwallex requests for additional information.
READY_FOR_DISPATCHThe 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_dispatchNo action needed.
DISPATCHEDThe 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.dispatchedNo action needed.
FAILEDThe 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.failedBefore 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.
RETRIEDThe 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.retriedTrack the new transfer created. Corresponding fees may apply (see Fees in retries).
CANCELLATION_REQUESTEDTransfer cancellation has been requested before DISPATCHED, and will transition to CANCELLED when the currency conversion (if any) is settled.payment.cancellation_requestedNo action needed.
CANCELLEDThe 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.cancelledCorresponding fees may apply (see Fees in cancellations).
SUSPENDEDThe 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.suspendedExpect 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.

Was this page helpful?
On this page
  • API ver. 2024-01-31 to 2025-06-16
  • API ver. 2023-10-01 and before
Was this page helpful?