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."


Did this page help you?