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_code_description: "Server busy" :error_handling: "Follow instructions in the response." |
| XFE2 | :error_code_description: "Access denied" :error_handling: "Make sure you call the correct API or contact customer support at https://bit.ly/XfersSupport." |
| XFE3 | :error_code_description: "Internal" :error_handling: "Unexpected error. Try again later or contact customer support at https://bit.ly/XfersSupport." |
| XFE4 | :error_code_description: "Authentication field empty" :error_handling: "Follow instructions in the response." |
| XFE5 | :error_code_description: "Api key is invalid" :error_handling: "Make sure you entered the correct API key or contact customer support at https://bit.ly/XfersSupport" |
| XFE6 | :error_code_description: "Invalid signature" :error_handling: "Follow instructions in the response." |
| XFE7 | :error_code_description: "Active record error_handling" :error_handling: "Follow instructions in the response." |
| XFE8 | :error_code_description: "Cannot retrieve media" :error_handling: "Cannot retrieve media. Please enter a new URL or try again later." |
| XFE9 | Error response has been deprecated |
| XFE10 | :error_code_description: "Invalid environment" :error_handling: "Request not supported for this environment." |
| XFE11 | :error_code_description: "Timeout" :error_handling: "Please try again later." |
| 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_code_description: "API only allowed for fully verified user" :error_handling: "Please submit KYC data to get your account fully verified." |
| XFE15 | :error_code_description: "Required parameter empty" :error_handling: "Make sure you entered the correct required parameter." |
| XFE16 | :error_code_description: "Invalid request" :error_handling: "API request not supported. Make sure you entered the correct API key or contact customer support at https://bit.ly/XfersSupport." |
XFE1XX: User
| User Errors (XFE1XX) | Error Message |
|---|---|
| XFE101 | :error_code_description: "Not local number" :error_handling: "Follow instructions in the response." |
| XFE102 | :error_code_description: "Entered value is less than minimum" :error_handling: "Make sure you entered the correct number." |
| XFE103 | Error response has been deprecated |
| XFE104 | :error_code_description: "Media provided too large" :error_handling: "Media too big. Follow the guidelines in the response." |
| XFE105 | :error_code_description: "Captcha error" :error_handling: "Follow instructions in the response." |
| XFE106 | :error_code_description: "No auth_code provided" :error_handling: "Enter either phone OTP or Google Auth OTP" |
| XFE107 | :error_code_description: "Only enter one auth_code" :error_handling: "Do not enter both OTP or Google Auth OTP. Only need to enter one." |
| XFE108 | :error_code_description: "More user information required" :error_handling: "Follow instructions in the response." |
| XFE109 | :error_code_description: "Invalid credentials" :error_handling: "Make sure you entered the correct credentials." |
| XFE110 | :error_code_description: "Cannot sign up twice" :error_handling: "Please sign in instead" |
| XFE111 | :error_code_description: "Duplicate credentials" :error_handling: "Particulars already exist. Please make sure you entered the correct parameters." |
| XFE112 | :error_code_description: "Repeat request" :error_handling: "API request has already been made. Please follow the instructions in the response or call another API." |
| XFE113 | :error_code_description: "The user's NRIC selfie is not verified." :error_handling: "Please submit NRIC selfie to get your account fully verified." |
XFE2XX: Merchant
| Merchant Errors (XFE2XX) | Error Message |
|---|---|
| XFE201 | :error_code_description: "Not yet a merchant" :error_handling: "Please verify your merchant or business account." |
XFE3XX: Account
| Account Errors (XFE3XX) | Error Message |
|---|---|
| XFE301 | :error_code_description: "Account locked" :error_handling: "Request not available. Please contact customer support at https://bit.ly/XfersSupport." |
| XFE302 | :error_code_description: "Account deleted" :error_handling: "Request not available. Please contact customer support at https://bit.ly/XfersSupport." |
| XFE303 | :error_code_description: "Account terminated" :error_handling: "Request not available. Please contact customer support at https://bit.ly/XfersSupport." |
| XFE304 | :error_code_description: "Account closed" :error_handling: "Request not available. Please contact customer support at https://bit.ly/XfersSupport." |
| XFE305 | :error_code_description: "Account limit reached" :error_handling: "Your request will exceed the account limit." |
| XFE306 | Error response has been deprecated |
| XFE307 | Error response has been deprecated |
| XFE308 | Error response has been deprecated |
| XFE309 | :error_code_description: "Cannot use same account" :error_handling: "Follow instructions in the response." |
| XFE310 | :error_code_description: "Account has insufficient funds" :error_handling: "Please ensure your account has sufficient balance." |
| XFE311 | :error_code_description: "Cannot be different wallet type" :error_handling: "Follow instruction in response or contact customer support at https://bit.ly/XfersSupport." |
| XFE312 | :error_code_description: "Conditions not met to close account" :error_handling: "Invalid request to close account. Follow instruction in the response." |
| XFE313 | :error_code_description: "Account not found" :error_handling: "Request not available. Please contact customer support at https://bit.ly/XfersSupport." |
XFE4XX: Charge
| Charge Errors (XFE4XX) | Error Message |
|---|---|
| XFE401 | :error_code_description: "Cannot refund charge" :error_handling: "Invalid request. Please call another API or contact customer support at https://bit.ly/XfersSupport." |
| XFE402 | :error_code_description: "Cannot use placeholder account" :error_handling: "Follow instructions in response." |
| XFE403 | Error response has been deprecated |
| XFE404 | :error_code_description: "Forex not supported" :error_handling: "Make sure you call the correct API or contact customer support at https://bit.ly/XfersSupport." |
| XFE405 | Error response has been deprecated |
| XFE406 | :error_code_description: "Cannot refund prepaid transaction" :error_handling: "Please choose another transaction to refund." |
| XFE407 | :error_code_description: "Conditions to charge card not met" :error_handling: "Invalid request for this transaction. Make sure you entered the correct txn_id." |
| XFE408 | :error_code_description: "Invalid charge request" :error_handling: "Invalid request. Please follow instructions in response or contact customer support at https://bit.ly/XfersSupport." |
| XFE409 | :error_code_description: "Order id exist" :error_handling: "Please enter another order_id." |
| XFE410 | :error_code_description: "Invalid application fee" :error_handling: "Invalid request. Please make changes to the parameters as stated in the response." |
| XFE411 | :error_code_description: "Will exceed storage limit" :error_handling: "Transfer will exceed the storage limit. Please change the amount or verify destination account." |
XFE5XX: Bank
| Bank Errors (XFE5XX) | Error Message |
|---|---|
| XFE501 | :error_code_description: "Expected Bank API error" :error_handling: "Try again later or contact customer support at https://bit.ly/XfersSupport." |
| XFE502 | :error_code_description: "Unexpected Bank API error" :error_handling: "Try again later or contact customer support at https://bit.ly/XfersSupport." |
| 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: "Bank account already taken" :error_handling: "Please use another bank account." |
| XFE507 | :error_code_description: "Bank account already added" :error_handling: "Please use another bank account." |
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." |
XFE7XX: Stablecoin
| Stablecoin Errors (XFE7XX) | Error Message |
|---|---|
| XFE701 | :error_code_description: "Unsupported Exchange" :error_handling: "Please ensure the exchange is supported or contact customer support at https://bit.ly/XfersSupport." |
| XFE702 | :error_code_description: "Unsupported Quote" :error_handling: "Please ensure the quote is supported or contact customer support at https://bit.ly/XfersSupport." |
| XFE703 | :error_code_description: "Invalid Address" :error_handling: "Please ensure the Address is correct or contact customer support at https://bit.ly/XfersSupport." |
XFE8XX: Dashboard
| Dashboard Errors (XFE8XX) | Error Message |
|---|---|
| XFE801 | :error_code_description: "Maximum Limit Xfers Dash Order" :error_handling: "You have reached the maximum number of disbursement request per day. Please try again tomorrow. If you still wish to send funds, please contact our customer support." |
Updated about 2 years ago