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 IDAPI). The failure_reason consists of a failure code and a failure description.
Please note that failed transfers will be automatically cancelled in seconds.
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 (99901 - 99902)
| Failure Code | Failure Description |
|---|---|
| 99901 | Unable to apply |
| 99902 | Other |
Recommended action: Contact Airwallex to troubleshoot the error.