Error Responses

The API categorises the various failures by their respective error codes. The body of the response will be JSON in the following format:

error: "string"
error_code: "string"
error_handling: "string"

The field error returns the error message specific to your request, error_code returns the unique code identifying the error and error_handling returns the instruction on how to resolve the error.

The string for error_code_description is used internally for our reference as some error codes have the same error_handling instructions but under completely different contexts. Should you face any difficulties with solving the errors, please contact Developer Support.

XFE0XX: General

General Errors (XFE0XX)

Error Message

XFE1

Error response has been deprecated

XFE2

Error response has been deprecated

XFE3

:error_code_description: "Internal"
:error_handling: "Unexpected error. Try again later or contact customer support at https://support.straitsx.com/hc/en-us/requests/new."

XFE4

Error response has been deprecated

XFE5

:error_code_description: "Api token is invalid"
:error_handling: "Make sure you entered the correct API key or contact customer support at https://support.straitsx.com/hc/en-us/requests/new."

XFE6

:error_code_description: "Access to this endpoint is denied"
:error_handling: "You do not have the necessary permissions to access this endpoint. Please contact customer support at https://support.straitsx.com/hc/en-us/requests/new for assistance."

XFE7

Error response has been deprecated

XFE8

Error response has been deprecated

XFE9

Error response has been deprecated

XFE10

:error_code_description: "Invalid environment"
:error_handling: "Request not supported for this environment."

XFE11

Error response has been deprecated

XFE12

:error_code_description: "Invalid parameter"
:error_handling: "Make sure you entered the correct parameters."

XFE13

:error_code_description: "Record not found"
:error_handling: "Please check that you provided the correct API Key and the correct parameters."

XFE14

Error response has been deprecated

XFE15

:error_code_description: "Required parameter empty"
:error_handling: "Make sure you entered the correct required parameter."

XFE16

:error_code_description: "Invalid request" or "Duplicated request"
:error_handling: "API request not supported. Make sure you entered the correct API key or contact customer support at https://support.straitsx.com/hc/en-us/requests/new."

XFE17

:error_code_description: "Insufficient customer profile data for USD"
:error_handling: "Please supplement missing information on Customer Profile required for USD capability"

XFE18

:error_code_description: "Invalid bank account for USD withdrawal"
:error_handling: "SWIFT code of this bank account is invalid"

XFE19

:error_code_description: "Invalid bank account for USD withdrawal"
:error_handling: "Bank account from a nonbank financial institution is not allowed for USD withdrawal"

XFE21

:error_code_description: "Insufficient account balance"
:error_handling: "Make sure you have sufficient balance and try again."

XFE22

:error_code_description: "Insufficient user kyb data for USD"
:error_handling: "Please supplement missing information on User KYB required for USD capability"

XFE5XX: Bank

Bank Errors (XFE5XX)

Error Message

XFE501

Error response has been deprecated

XFE502

Error response has been deprecated

XFE503

:error_code_description: "Failed name check"
:error_handling: "Bank account name and name provided have to be similar."

XFE504

:error_code_description: "Maximum number of bank accounts"
:error_handling: "Delete existing bank accounts."

XFE505

:error_code_description: "Bank abbrev provided invalid"
:error_handling: "Use GET {{base-api-url}}api/v3/banks to get the correct bank abbrev."

XFE506

:error_code_description: "Required bank data are empty"
:error_handling: "Bank abbrev, bank account no, and bank account name are required."

XFE507

Error response has been deprecated

XFE6XX: Withdrawal

Withdrawal Errors (XFE6XX)

Error Message

XFE601

:error_code_description: "Conditions to withdraw not met. Can be solved by changing amount"
:error_handling: "Your withdrawal does not meet the conditions required. Please follow the instructions in the response."

XFE602

:error_code_description: "Exceeds limit. Need to wait it out."
:error_handling: "Your withdrawal exceeds the limit for the time period. Please change the amount or verify your account."

XFE603

:error_code_description: "Not allowed to carry out request"
:error_handling: "Invalid request. Please call another API or contact customer support at https://bit.ly/XfersSupport."

XFE604

:error_code_description: "Maximum Limit Merchant Withdrawal"
:error_handling: "You have reached the maximum number of withdrawal request per day. Please try again tomorrow. If you still wish to make a withdrawal, please contact our customer support."