Error codes

This page lists all the possible errors associated with the HTTP 400 status code while creating/managing conversions and conversion amendments 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": "amount_above_limit",
3   "message": "Buy amount above the limit of USD 5000000 equivalent",
4   "source": "buyCurrency"
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}

See below for all potential error codes and descriptions, organized by corresponding Conversion API & Conversion Amendments API endpoints.

Conversion errors

Error codes and detailed descriptions for Create a new conversion API, Retrieve a conversion API and List all conversions API.

| Code | Description | Next steps | | ----------------- | ---------------- | | amount_above_limit | The amount requested exceeds the maximum conversion limit. Default is $5,000,000 USD. | Lower the conversion amount or speak to you account manager to change your limits. | | amount_below_limit | The amount requested falls below the minimum conversion limit. Default is $1 USD. | Increase the conversion amount or speak to you account manager to change your limits. | | field_required | A mandatory field in the request is missing. | See the message and source code in the response. | | invalid_conversion_date | The conversion creation request failed as the conversion_date is invalid. Default supported value date is T+2. | You can convert 24/7/365. The date must be a valid date (YYYY-MM-DD) in the future, up to your supported value date. | | invalid_argument | A provided argument has an incorrect type or failed a validation test. | See the message and source code in the response. | | term_agreement_is_required | You must agree to Airwallex's Terms and Conditions to create a conversion. | term_agreement must be set to true | | unsupported_currency | The buy or sell currency is invalid. | Must be a three-letter ISO 4217 currency code. See supported currencies. | | invalid_quote_id | The request failed. | Use a valid quote_id or speak to your account manager. | | expired_quote | The quote is expired. | Use a valid quote_id or speak to your account manager. | | conflict_original_ccy | The quote currencies differ from the currencies in the create conversion request. | Must be a three-letter ISO 4217 currency code. See supported currencies. | | operation_failed | The request failed. | Contact support or speak to your account manager. | | not_found | The conversion was not found for the request. | Use a valid conversion_id or speak to your account manager. | | insufficient_funds | Insufficient funds in sell_currency to execute conversion. | Lower the conversion amount or add funds to your sell_currency wallet . | | credit_limit_exceeded | You have exceeded the upper limit of unfunded transactions you can have open with Airwallex at any one time. | Lower the conversion amount, settled unfunded transactions or speak to your account manager to increase your limit. See Funding and Settlement Models for more information. | | incorrect_version | The version is incorrect for endpoint. | Ask your account manager to change your API version or use x-api-version in the header. |

Rates and Quotes errors

Error codes and detailed descriptions for Create a quote API and Retrieve a current rate API.

| Code | Description | Next steps | | ----------------- | ---------------- | | incorrect_version | The version is incorrect for endpoint. | Ask your account manager to change your API version or use x-api-version in the header. | | validation_error | The amount requested falls below the minimum conversion limit. Default is $1 USD. | See the message and source code in the response. | | field_required | A mandatory field in the request is missing. | See the message and source code in the response. | | invalid_conversion_date | The conversion creation request failed as the conversion_date is invalid. Default supported value date is T+2. | You can convert 24/7/365. The date must be a valid date (YYYY-MM-DD) in the future, up to your supported value date. | | invalid_argument | A provided argument has an incorrect type or failed a validation test. | See the message and source code in the response. | | invalid_parameter | The buy or sell currency is invalid. | Must be a three-letter ISO 4217 currency code. See supported currencies. |

Conversion amendments errors

Error codes and detailed descriptions for Create an amendment quote API, Create an amendment API, Retrieve an amendment API and List all amendments API.

| Code | Description | Next steps | | ----------------- | ---------------- | | account_not_authorized | The account is not authorised to amend conversions. | Only post-fund and pre-fund accounts can amend conversions See Conversion Amendments for more information. | | does_not_exist | The conversion does not exist. | Provide a valid conversion_id. | | field_required | A mandatory field in the request is missing. | See the message and source code in the response. | | invalid_status_for_operation | The conversion is in a state that cannot be amended. | Only conversions in SCHEDULED and OVERDUE can be cancelled. See Conversion Statuses for more information. | | invalid_charge_currency | The charge_currency is neither buy currency nor sell currency. | Only the currencies from the original conversion are allowed. Must be a three-letter ISO 4217 currency code. | | invalid_argument | A provided argument has an incorrect type or failed a validation test. | See the message and source code. |