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 after a certain time depending on the region you are in. Alternatively, you can Cancel the transfer and create a new one with updated parameters. 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 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: Cancel the transfer and create a new one with updated parameters.
Account information mismatch (90301 - 90302)
| Failure Code | Failure Description |
|---|---|
| 90301 | Beneficiary name mismatch |
| 90302 | Account currency mismatch |
Recommended action: Cancel the transfer and create a new one with updated parameters.
Invalid beneficiary details (90401 - 90402)
| Failure Code | Failure Description |
|---|---|
| 90401 | Invalid beneficiary details |
| 90402 | Invalid special character |
Recommended action: Cancel the transfer and create a new one with updated parameters.
Internal policy (90501 - 90502)
| Failure Code | Failure Description |
|---|---|
| 90501 | Channel policy |
| 90502 | TM suspended |
Recommended action: Cancel the transfer as it cannot be processed further after internal review.
Abnormal account status (90701 - 90703)
| Failure Code | Failure Description |
|---|---|
| 90701 | Account closed |
| 90702 | Account inactive or dormant |
| 90703 | Account under restriction |
Recommended action: Cancel the transfer and 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: Cancel the transfer as it has been returned by the beneficiary bank. If this 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 | Beneficairy account type not supported |
| 90904 | Chinese company registration number error |
| 91201 | China local transfer processing failure |
Recommended action: Cancel the transfer and contact Airwallex to troubleshoot the error.
Client requested (91001 - 91002)
| Failure Code | Failure Description |
|---|---|
| 91001 | Recall requested |
| 91002 | Client requested |
Recommended action: Cancel the transfer as it could not be processed successfully. Contact Airwallex to troubleshoot the error.
Invalid payment purpose (91101)
| Failure Code | Failure Description |
|---|---|
| 91101 | Invalid payment purpose |
Recommended action: Cancel the transfer as it could not be processed successfully. Contact Airwallex to troubleshoot the error.
System error (91401 - 91402)
| Failure Code | Failure Description |
|---|---|
| 91401 | System error |
| 91402 | Channel timeout |
Recommended action: Cancel the transfer as it could not be processed successfully. Contact Airwallex to troubleshoot the error.
Other (99902)
| Failure Code | Failure Description |
|---|---|
| 99902 | Other |
Recommended action: Cancel the transfer as it could not be processed successfully. Contact Airwallex to troubleshoot the error.