Linked Accounts

Simulate the Linked Account lifecycle scenarios in the sandbox environment.

Endpoints

POST /api/v1/simulation/linked_accounts/{linked_account_id}/mandate/accept
POST /api/v1/simulation/linked_accounts/{linked_account_id}/mandate/reject
POST /api/v1/simulation/linked_accounts/{linked_account_id}/mandate/cancel
POST /api/v1/simulation/linked_accounts/{linked_account_id}/fail_microdeposits

Accept a Mandate

POST /api/v1/simulation/linked_accounts/{linked_account_id}/mandate/accept

Copy for LLMView as Markdown

Accept a Mandate by transitioning the mandate status from PROCESSING to ACTIVE.

Path parameters

linked_account_idrequiredstring

Unique identifier of the Linked Account.

Response body - 200 OK

Errors

Error status	Description
400	Possible errors: `invalid_argument`, `invalid_status_for_operation`
401	credentials_invalid
500	service_unavailable

POST /api/v1/simulation/linked_accounts/{linked_account_id}/mandate/accept

$curl --request POST \
>  --url 'https://api.sandbox.airwallex.com/api/v1/simulation/linked_accounts/linked_account_id/mandate/accept' \
>  --header 'Authorization: Bearer {{ACCESS_TOKEN}}' \
>  --header 'Content-Type: application/json'

Was this section helpful?

Reject a Mandate

POST /api/v1/simulation/linked_accounts/{linked_account_id}/mandate/reject

Copy for LLMView as Markdown

Reject a Mandate by transitioning the mandate status from PROCESSING to INACTIVE.

Path parameters

linked_account_idrequiredstring

Unique identifier of the Linked Account.

Response body - 200 OK

Errors

Error status	Description
400	Possible errors: `invalid_argument`, `invalid_status_for_operation`
401	credentials_invalid
500	service_unavailable

POST /api/v1/simulation/linked_accounts/{linked_account_id}/mandate/reject

$curl --request POST \
>  --url 'https://api.sandbox.airwallex.com/api/v1/simulation/linked_accounts/linked_account_id/mandate/reject' \
>  --header 'Authorization: Bearer {{ACCESS_TOKEN}}' \
>  --header 'Content-Type: application/json'

Was this section helpful?

Cancel a Mandate

POST /api/v1/simulation/linked_accounts/{linked_account_id}/mandate/cancel

Copy for LLMView as Markdown

Cancel a Mandate by transitioning the mandate status from PROCESSING or ACTIVE to INACTIVE.

Path parameters

linked_account_idrequiredstring

Unique identifier of the Linked Account.

Response body - 200 OK

Errors

Error status	Description
400	Possible errors: `invalid_argument`, `invalid_status_for_operation`
401	credentials_invalid
500	service_unavailable

POST /api/v1/simulation/linked_accounts/{linked_account_id}/mandate/cancel

$curl --request POST \
>  --url 'https://api.sandbox.airwallex.com/api/v1/simulation/linked_accounts/linked_account_id/mandate/cancel' \
>  --header 'Authorization: Bearer {{ACCESS_TOKEN}}' \
>  --header 'Content-Type: application/json'

Was this section helpful?

Fail a Micro Deposits Verification

POST /api/v1/simulation/linked_accounts/{linked_account_id}/fail_microdeposits

Copy for LLMView as Markdown

Fail a Micro Deposits verification by transitioning the Linked Account status from REQUIRES_ACTION to FAILED with the reason MICRO_DEPOSIT_FAILED.

Path parameters

linked_account_idrequiredstring

Unique identifier of the Linked Account.

Response body - 200 OK

Errors

Error status	Description
400	Possible errors: `invalid_argument`, `invalid_status_for_operation`
401	credentials_invalid
500	service_unavailable

POST /api/v1/simulation/linked_accounts/{linked_account_id}/fail_microdeposits

$curl --request POST \
>  --url 'https://api.sandbox.airwallex.com/api/v1/simulation/linked_accounts/linked_account_id/fail_microdeposits' \
>  --header 'Authorization: Bearer {{ACCESS_TOKEN}}' \
>  --header 'Content-Type: application/json'

Was this section helpful?