Linked Account statuses
This page describes the status transitions during Linked Account creation and verification.
Linked Account Statuses
Status transitions when you initiate a request to create a Linked Account that links to an external bank account, and subsequently verify it with micro-deposits.
| Status | Description |
|---|---|
| REQUIRES_ACTION | Indicates that customer action such as verifying the Linked Account with microdeposits is pending. |
| PROCESSING | Linked account activation is in progress or United Kingdom direct debit mandate is being registered. The customer should wait for the status to update. |
| SUCCEEDED | The request to create a Linked Account was successful. |
| FAILED | The request to create a Linked Account was unsuccessful. |
| SUSPENDED | Linked account has been suspended by Airwallex. |
You can subscribe to Linked Account webhook events to receive notifications in case of any status transitions.
Failure reasons
When the status of the Linked Account is FAILED or REQUIRES_ACTION, the reason field provides details. If there are no additional details, null will be returned.
| Linked Account Status | Reason | Description |
|---|---|---|
| REQUIRES_ACTION | MANDATE_FAILED | Mandate creation failed. |
| FAILED | VERIFICATION_FAILED | Unspecified errors default to VERIFICATION_FAILED. |
| FAILED | MICRO_DEPOSIT_FAILED | Micro-deposit verification failed. |
| FAILED | NAME_MATCH_FAILED | The name provided does not match the name on the Linked Account. |