Error codes

Airwallex uses conventional HTTP response codes to indicate the success or failure of an API request. Typically a response code in the 2xx range indicates response, status codes in the 4xx range indicate an error that has been triggered due to the information provided (for example; a parameter does not meet the validation requirements or was not provided), and also for an error with our servers.

HTTP response codes

HTTP Response Codes and description

Code	Description
200	OK - The request was processed successfully
201	Created - The request was processed successfully
400	Bad request - The request contains missing parameters, is in an incorrect shape, or failed another validation test
401	Unauthorized - Please verify that the authentication token is provided and is valid
404	Not found - The requested endpoint does not exist

Error response structure

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

Name	Type	Description	Example
code	String	Error code	validation_error
source	String	Name of the request parameter that caused the error (This attribute is only for code validation_error)	merchant_order_id
message	String	Description of the error	merchant_order_id must be provided [40.01.02]

Response Examples

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 retry again at a later time [[54.07.01]]"
}

Error codes for 401, 404

Error Codes for HTTP Response code 401 and 404

Http response code	Code	Message
401	unauthorized	Access denied, authentication failed
404	not_found	The requested endpoint does not exist

Error codes for 400

Error Codes for HTTP Response code 400

Code	Message
validation_error	merchant_order_id must be provided. (e.g.)
duplicate_request	The same request ID has already been used. Please try again with a different request ID.
resource_not_found	The resource with ID [$resourceId] cannot be found.
resource_already_exists	The resource with ID [$resourceId] already exists.
state_invalid_for_operation	Cannot $operation the $resource of status $status.
service_unavailable	The system is temporarily unavailable. Please try again later. [$internalCode]
processor_unavailable	The processor is temporarily unavailable. Please try again later. [$internalCode]
processor_busy	The processor is busy. Please try again later.
processor_declined	The processor declined this transaction.
amount_above_limit	The $operation amount is above the limit. The maximum amount you can $operation is $amount.
frequency_above_limit	Failed to $operation the $resource. Frequency limit is reached. Please try again later.
transaction_blocked	The transaction is currently blocked by the fraud detection system.
payment_blocked	Payment processing has been suspended by the risk monitoring system. Please contact your account manager for further information.
refund_not_allowed	Refund is not allowed for this payment. Please refer to the API reference for possible reasons.
unsupported_operation_on_payment_method	The $paymentMethod payment method does not support $operation.
capture_amount_above_limit	The capture amount $captureAmount exceeds the capturable amount $capturableAmount.
refund_amount_above_limit	The refund amount $refundAmount exceeds the refundable amount $refundableAmount.
insufficient_available_funds	Failed to process this request. The account does not have sufficient available funds.
insufficient_incoming_funds	Failed to process this request. The account does not have sufficient incoming funds.
processor_user_account_abnormal	The processor refused the request and reported the account as abnormal.
processor_refund_period_expired	The processor refused the request since the refund period has expired.
processor_refund_offline_required	The processor requires this refund request to be processed offline.