Search...
Log inGet started
Airwallex logo
Home
Core API
Payments
Transactional FX
Payouts
Issuing
Back to home
OverviewHow Transactional FX worksSupported regions and currenciesFunding and settlement models
Use Cases
Troubleshooting
Error codes
Test and go live

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

Example with details:

JSON

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.

CodeDescriptionNext steps
amount_above_limitThe 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_limitThe 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_requiredA mandatory field in the request is missing.See the message and source code in the response.
invalid_settlement_dateThe 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_argumentA provided argument has an incorrect type or failed a validation test.See the message and source code in the response.
term_agreement_is_requiredYou must agree to Airwallex's Terms and Conditions to create a conversion.term_agreement must be set to true
unsupported_currencyThe buy or sell currency is invalid.Must be a three-letter ISO 4217 currency code. See supported currencies.
invalid_quote_idThe request failed. This can occur if you use an invalid LockFX variation for your account configuration (for example, HR_24 validity when your account is set to Short).Use a valid quote_id or speak to your account manager.
expired_quoteThe LockFX quote is expired.Use a valid quote_id or speak to your account manager.
conflict_original_ccyThe LockFX quote currencies differ from the currencies in the create conversion request.Must be a three-letter ISO 4217 currency code. See supported currencies.
invalid_endpointThe endpoint you are trying to access is invalid. This might occur if you are configured for MarketFX but are trying to use a LockFX endpoint or vice versa.Use the correct endpoint for your account.
operation_failedThe request failed. This can occur if you use an invalid LockFX variations for your account configuration (for example, HR_24 validity when your account is set to Short).Use the correct validity or speak to your account manager.
not_foundThe conversion was not found for the request.Use a valid conversion_id or speak to your account manager.
insufficient_fundsInsufficient funds in sell_currency to execute conversion.Lower the conversion amount or add funds to your sell_currency wallet .
credit_limit_exceededYou 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.

LockFX and MarketFX errors

Error codes and detailed descriptions for Create a LockFX quote API and Retrieve an indicative MarketFX quote API.

CodeDescriptionNext steps
amount_above_limitThe 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_limitThe 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_requiredA mandatory field in the request is missing.See the message and source code in the response.
invalid_settlement_dateThe 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_argumentA provided argument has an incorrect type or failed a validation test.See the message and source code in the response.
unsupported_currencyThe buy or sell currency is invalid.Must be a three-letter ISO 4217 currency code. See supported currencies.
operation_failedThe request failed. This can occur if you use an invalid LockFX variations for your account configuration (for example, HR_24 validity when your account is set to Short).Use the correct validity or speak to your account manager.
invalid_endpointThe endpoint you are trying to access is invalid. This might occur if you are configured for MarketFX but are trying to use a LockFX endpoint or vice versa.Use the correct endpoint for your account.
invalid_lock_fx_settingsYour account isn't configured correctly for the request.Speak to your account manager.
credit_limit_exceededYou 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.

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.

CodeDescriptionNext steps
account_not_authorizedThe 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_existThe conversion does not exist.Provide a valid conversion_id.
field_requiredA mandatory field in the request is missing.See the message and source code in the response.
invalid_status_for_operationThe conversion is in a state that cannot be amended.Only conversions in PENDING_SETTLEMENT and AWAITING_FUNDS can be cancelled. See Conversion Statuses for more information.
invalid_charge_currencyThe 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_argumentA provided argument has an incorrect type or failed a validation test.See the message and source code.
On this page
  • Conversion errors
  • LockFX and MarketFX errors
  • Conversion amendments errors