Simulate cardholder status transition

You can conduct unit and end-to-end testing of your Issuing cardholder integration by simulating cardholder status transition while bypassing cardholder screening process. To learn more about creating cardholders and handling RFI, see Create cardholders.

Key test scenarios include:

Creating cardholders and transitioning cardholder status to READY by bypassing RFI.

As a platform account, you can call the simulation APIs on behalf of a connected account using the x-on-behalf-of header.

Transition cardholder status

Create an individual cardholder by specifying individual cardholder type requirements in Create a cardholder API. To transition the cardholder to the PENDING status, you must specify test data in individual.address.line2 and individual.name fields. Please contact your Airwallex Account Manager to obtain this data.

In the sandbox environment, Airwallex will bypass cardholder screening by default, and the cardholder status will transition to READY status immediately.

A PENDING state indicates that further review may be required, and Airwallex will typically initiate the RFI process with the cardholder to gather additional information.

When the cardholder status is PENDING, call Pass review stage of a cardholder API using the cardholder_id to bypass the Request for Information (RFI) process and set the card_status to READY.

Shell
1curl --request POST
2--url 'https://api-demo.airwallex.com/api/v1/simulation/issuing/cardholders/d8af1614-a6a1-4d45-aae7-6858fc6d9ede/pass_review'
3--header 'Content-Type: application/json'
4--header 'Authorization: Bearer <your_bearer_token>'

If the request is successful, HTTP status 200 OK will be returned. Otherwise, an error code will be returned.

Troubleshooting

You might encounter the following errors when simulating cardholder APIs.

Error scenario	Error code	Error response	Recommended actions
Cardholder not found	not_found	`{` `"code": "not_found",` `"message": "Cardholder not found."` `}`	Provide a valid cardholder ID in `PENDING` status. See Cardholder statuses.
Event error	internal_error	`{` `"code": "internal_error",` `"message": "Internal error."` `}`	An unexpected error occurred on our end. Please try again later. If the issue persists, contact Airwallex support.

Was this page helpful?