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
READYby 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 demo 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.
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 | {
|
Provide a valid cardholder ID in PENDING status. See Cardholder statuses. |
| Event error | internal_error | {
|
An unexpected error occurred on our end. Please try again later. If the issue persists, contact Airwallex support. |