Failure reasons
You can learn about the cause of a failure from the failure_reason field of a failed payout, by either listening for the payment.failed webhook event or retrieving the payout via API request (Get payment by ID API). The failure_reason consists of a failure code and a failure description.
Please note that failed payouts will be automatically cancelled after a certain time depending on the region you are in. Alternatively, you can Cancel the payout 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 payouts.
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 payout 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 payout 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 payout 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 payout 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 payout and inform your beneficiary that the payout 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 payout 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 payout error (90901 - 90904, 91201)
| Failure Code | Failure Description |
|---|---|
| 90901 | China local payout beneficiary validation error |
| 90902 | China local payout order error |
| 90903 | Beneficairy account type not supported |
| 90904 | Chinese company registration number error |
| 91201 | China local payout processing failure |
Recommended action: Cancel the payout 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 payout 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 payout 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 payout 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 payout as it could not be processed successfully. Contact Airwallex to troubleshoot the error.