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." |
Updated 27 days ago