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 is consisted of a failure code and a failure description.
There are two actions you can take while handling a failed payout:
- Retry the payout by calling Retry a payment API with updated parameters in your request.
- Cancel the payout by calling Cancel a payment API.
Alternatively, you can wait for the failed payout to be automatically cancelled by Airwallex after a certain time depending on the region you are in. 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 about the behaviors of the two actions 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: Retry the payout.
Account information mismatch (90301 - 90302)
| Failure Code | Failure Description |
|---|---|
| 90301 | Beneficiary name mismatch |
| 90302 | Account currency mismatch |
Recommended action: Retry the payout.
Invalid beneficiary details (90401 - 90402)
| Failure Code | Failure Description |
|---|---|
| 90401 | Invalid beneficiary details |
| 90402 | Invalid special character |
Recommended action: Retry the payout.
Internal policy (90501)
| Failure Code | Failure Description |
|---|---|
| 90501 | Channel policy |
Recommended action: Cancel the payout as it cannot be processed further due to our banking partner’s policy.
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.