Error codes

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:

JSON
1{
2   "code": "invalid_argument",
3   "message": "Type should be one of BRN, EIN, SSN, VAT.",
4   "source": "individual.employers[0].business_identifiers[0].type"
5}

Example with details:

JSON
1{
2   "code": "account_not_authorized",
3   "details": [
4       {
5           "code": "correlation_id",
6           "message": "26eebb32-36a8-4764-a2af-9621426b1aa4"
7       }
8   ],
9   "message": "account not authorised [POST_TX_CREATION]",
10   "source": "account"
11}

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.

Transaction Failures

To troubleshoot transactions that have been declined, please refer to this page.