Airwallex logo

Error Codes

Airwallex uses conventional HTTP response codes to indicate the success or failure of an API request.

HTTP response codes

HTTP Response Codes and description

CodeDescription
200OK - The request was processed successfully
201Created - The request was processed successfully
400Error - The request was invalid, or an error occurred in Airwallex or downstream provider
401Unauthorized - Please verify that the authentication token is provided and is valid
404Not found - The requested endpoint does not exist

Error response structure

When we send an error response, the body will generally contain the following fields:

Response Body Attributes

NameTypeDescriptionExample
codeStringError codevalidation_error
sourceStringName of the request parameter that caused the error (This attribute is only for code validation_error)merchant_order_id
messageStringError messagemerchant_order_id must be provided
providerOriginalResponseCodeStringOriginal response code from downstream provider (This attribute is only for code processor_declined or issuer_declined)01

Error response examples for HTTP response code 400

validation_error

{   
"code":"validation_error",
"source":"merchant_order_id",
"message":"merchant_order_id must be provided"
}

resource_not_found

{   
"code":"resource_not_found",
"message":"The resource with ID int_n3fXc5NDzgVE9DLx3zGhMibdSlx cannot be found"
}

service_unavailable

{   
"code":"service_unavailable",
"message":"The system is temporarily unavailable. Please try again later. [54.07.01]"
}

issuer_declined

{   
"code":"issuer_declined",
"message":"TThe issuer declined this transaction.",
"provider_original_response_code": "01"
}

Error codes for 401, 404

Error Codes for HTTP Response code 401 and 404

Http response codeCodeMessage
401unauthorizedAccess denied, authentication failed
404not_foundThe requested endpoint does not exist

Error codes for 400

Error Codes for HTTP Response code 400

CodeMessage
validation_error{massages vary by validation rules}
configuration_errorThe operation is invalid against merchant configuration. Please contact your account manager.
duplicate_requestThe same request ID has already been used. Please try again with a different ID.
resource_not_foundThe resource with ID \$Id cannot be found.
resource_already_existsThe resource with ID \$Id already exists.
state_invalid_for_operationCannot $operation the $resource of status $status.
service_unavailableThe system is temporarily unavailable. Please try again later. [$internalCode]
provider_unavailableThe payment provider is temporarily unavailable. Please try again later.
issuer_unavailableThe card issuer is temporarily unavailable. Please try again later.
provider_declinedThe payment provider declined this transaction.
issuer_declinedThe issuer declined this transaction.
risk_declinedThe transaction is blocked because of risk concern. Please contact your account manager.
amount_above_limitThe operating amount is above the limit. Please adjust the amount and try again.
frequency_above_limitFailed to $operation the $resource. Frequency limit is reached. Please try again later.
operation_not_supportedThe operation is not supported. Please contact your account manager.
currency_not_supportedThe currency $currency is not supported according to merchant’s configuration. Please update the currency or contact your account manager.
quote_expiredThe quote has expired. Please create a new quote and try again.
card_invalidThe card is invalid. Please update your card information or try another card.
card_brand_not_supportedThe card brand $brand is not supported.
authentication_declinedUser failed 3DS authentication.