Failure reasons
You can learn about the cause of a failure from the failure_reason field of a failed transfer, by either listening for the payout.transfer.failed webhook event or retrieving the transfer via API request (Get transfer by ID API). The failure_reason consists of a failure code and a failure description.
Please note that failed transfers will be automatically cancelled in seconds. Please reach out to your Account Manager to find out more.
Use the table below to understand the failure_reason and determine the next steps to take. You can learn more in Handle failed transfers.
Invalid account name/number (90101)
| Failure Code | Failure Description |
|---|---|
| 90101 | Invalid account name/number |
Recommended action: Create a new transfer with updated parameters.
Invalid bank information (90201 - 90204)
| Failure Code | Failure Description |
|---|---|
| 90201 | Invalid bank/branch code |
| 90202 | Invalid SWIFT/BIC code |
| 90203 | Invalid correspondent bank information |
| 90204 | Invalid bank information |
Recommended action: Create a new transfer with updated parameters.
Account information mismatch (90301 - 90302)
| Failure Code | Failure Description |
|---|---|
| 90301 | Beneficiary name mismatch |
| 90302 | Account currency mismatch |
Recommended action: Create a new transfer with updated parameters.
Invalid beneficiary details (90401 - 90402)
| Failure Code | Failure Description |
|---|---|
| 90401 | Invalid beneficiary details |
| 90402 | Invalid special character |
Recommended action: Create a new transfer with updated parameters.
Internal policy (90501 - 90502)
| Failure Code | Failure Description |
|---|---|
| 90501 | Channel policy |
| 90502 | TM suspended |
Recommended action: As it cannot be processed further after internal review, after the transfer is cancelled, please create a new one with updated parameters.
Funding error (90604)
| Failure Code | Failure Description |
|---|---|
| 90604 | Insufficient balance |
Recommended action: Please top up your wallet balance before creating the transfer again.
Abnormal account status (90701 - 90703)
| Failure Code | Failure Description |
|---|---|
| 90701 | Account closed |
| 90702 | Account inactive or dormant |
| 90703 | Account under restriction |
Recommended action: Inform your beneficiary that the transfer failed due to the beneficiary account being closed/inactive/restricted.
Beneficiary requested (90801 - 90802)
| Failure Code | Failure Description |
|---|---|
| 90801 | Beneficiary requested |
| 90802 | Beneficiary bank returned |
Recommended action: If beneficiary bank return is unexpected, please advise your beneficiary to check with the receiving bank.
China local transfer error (90901 - 90904, 91201)
| Failure Code | Failure Description |
|---|---|
| 90901 | China local transfer beneficiary validation error |
| 90902 | China local transfer order error |
| 90903 | Beneficiary account type not supported |
| 90904 | Chinese company registration number error |
| 91201 | China local transfer processing failure |
Recommended action: Contact Airwallex to troubleshoot the error.
Client requested (91001 - 91002)
| Failure Code | Failure Description |
|---|---|
| 91001 | Recall requested |
| 91002 | Client requested |
Recommended action: Contact Airwallex to troubleshoot the error.
Invalid payment purpose (91101)
| Failure Code | Failure Description |
|---|---|
| 91101 | Invalid payment purpose |
Recommended action: Update the payment purpose or contact Airwallex to troubleshoot the error.
System error (91401 - 91402)
| Failure Code | Failure Description |
|---|---|
| 91401 | System error |
| 91402 | Channel timeout |
Recommended action: Contact Airwallex to troubleshoot the error.
Other (99902)
| Failure Code | Failure Description |
|---|---|
| 99902 | Other |
Recommended action: Contact Airwallex to troubleshoot the error.