Error codes
This page describes error codes for API version 2024-03-31 or later.
This page lists all the possible errors associated with the HTTP 400 status code while creating/managing cardholders, cards and disputes via our API endpoints.
For 400 errors, the response you receive will contain a code specifying the error encountered, message about the error, and source providing additional context about the error.
General errors with example response
A general error provides an error response with code, message, source. Like in the example below, the response contains an errors object with:
code: Unique numeric identifier of the specific validation error encountered.message: A message about the specific error encountered.source: The specific field or object within the request that has failed.details: Additional details about the request. Generally includes error code trace ID (correlation_id) for Airwallex debugging.
Example:
Example with details:
Cardholder errors
Error codes and detailed descriptions for Create a cardholder API, Update a cardholder API.
| Code | Description | Next steps |
|---|---|---|
bad_request | Another cardholder already exists with the same email or there is a cardholder without an email but has the same phone number. | Try the request again with a different email or phone number. |
invalid_argument | A provided argument has an incorrect type or failed a validation test. | See the message and source code in the response. |
Card errors
Error codes and detailed descriptions for Create a card API and Update a card API.
| Code | Description | Next steps |
|---|---|---|
bad_request | name_on_card has been deprecated and will be replaced by either cardholder or business name. | Remove name_on_card from the payload. |
invalid_argument | A provided argument has an incorrect type or failed a validation test. | See the message and source code in the response. |
not_found | Cardholder not found: CARDHOLDER_ID. | Make sure the cardholder_id and additional_cardholder_ids provided in the payload exists. |
field_required | cardholder_id must be provided. | Provide a cardholder_id. |
Dispute errors
Error codes and detailed descriptions for Create a dispute API, Submit a dispute API, Update a dispute API.
| Code | Description | Next steps |
|---|---|---|
invalid_argument |
A provided argument has an incorrect type or failed a validation test. | You may receive this when the dispute `reason` is SUSPECTED_FRAUD and the transaction is deemed to have no dispute rights. Do not submit the dispute as it will be rejected. |