Error Codes

This section outlines the possible error codes returned from API calls. These codes help developers to understand the specific reasons behind an unsuccessful user or transaction creation.

List of Error Codes

Error CodeError TypeEndpointDescriptions
CUSTOMER_NOT_FOUNDAuthenticationAllThe username and password used for authentication could not be found in the system.
UNAUTHORIZED_CUSTOMERAuthenticationAllThe MID header is either empty or could not be found in the system.
INVALID_ARGUMENTSExternalAllInvalid arguments provided in the request.
MISSING_ARGUMENTSExternalAllRequired arguments are missing from the request.
CURRENCY_NOT_FOUNDRatesAllThe requested currency is not supported or not found.
QUOTES_LIMIT_ERRORRatesExchanges Rates, OrderThe provided amount is not in the limits for selected trading pair.
QUOTES_EXPIREDRatesExchanges Rates, OrderThe provided quotes have expired and are no longer valid.
CONFLICTUserUserThe user is already available in the system.
USER_NOT_FOUNDUserUserThe specified user could not be found in the system.
AGE_LIMIT_ERRORUserUserThe individual user age should be between the limits.
FILE_REQUIREDInvoiceOrderA invoice is required to perform transaction.
INVALID_PAYMENT_CODEOrderOrderThe payment code provided is invalid or incorrect.
INSUFFICIENT_BALANCEOrderOrderThe account has insufficient balance to complete the transaction.
INVALID_QR_STRINGOrderOrderQR String Validation Error
QR_DETAILS_FETCH_FAILEDOrderOrderFailed to fetch QR details from PMS
INVALID_QR_DETAILSOrderOrderInvalid QR code details received. Merchant name is not available in QR String.
INVALID_QR_AMOUNTOrderOrderInvalid amount provided. Please ensure the amount is neither 0 or matches the qrCode amount.
EMAIL_VERIFICATION_FAILEDComplianceUser, OrderEmail verification is failed and cannot be used for contact creation. Please contact support for further assistance.
EMAIL_UNDER_MANUAL_REVIEWComplianceUser, OrderEmail is under manual review. Please wait 24-48 hours or contact support.
DEVICE_UNDER_MANUAL_REVIEWComplianceOrderPlease note the contact is under manual review with compliance due to device & biometric risk check. Please wait for 24-48 hours for final outcome or contact support for further assistance.
DEVICE_VERIFICATION_FAILEDComplianceOrderPlease note the contact is disabled due to device & biometric check failed. Please contact support for further assistance.
KYT_UNUSUAL_BEHAVIOUR_MANUAL_REVIEWComplianceOrderPlease note this account is under manual review with compliance as system has flagged the unusual transaction behaviour. Please wait for 24-48 hours for final outcome or contact support for further assistance.
KYT_VELOCITY_RISK_TEMP_BLOCKComplianceOrderPlease note this account is disabled for 24 hours from the last attempted transaction as system has flagged the unusual transaction behaviour. Please contact support for further assistance or retry after 24 hours.
KYT_UNUSUAL_BEHAVIOUR_PERM_BLOCKComplianceOrderPlease note this account is disabled due to system has flagged the unusual transaction behaviour. Please contact support for further assistance or if you wish to reinstate this account.
STANDARD_KYC_REQUIREDComplianceOrderLimit breached – Standard KYC is required.
ENHANCED_KYC_REQUIREDComplianceOrderLimit breached – Enhanced KYC is required.
BASIC_SCREENING_IN_PROGRESSComplianceOrderUser creation is in progress. User's Basic KYC is pending.
BASIC_SCREENING_REJECTEDComplianceOrderUser KYC has been rejected.
KYC_EXPIREDComplianceOrderUser KYC document has expired.
RESUBMISSION_REQUIREDComplianceOrderUser KYC failed – Please resubmit your KYC.
MAXIMUM_LIMIT_BREACHEDComplianceOrderMaximum transaction limit reached. No further orders will be accepted for this user.
RESTRICTED_ACCESSOrderOrderThe user is not allowed to do transaction.
INTERNAL_SERVER_ERRORInternalSystemAn internal server error occurred while processing the request.
SYSTEM_ERRORInternalSystemAn internal system error occurred.
PAYMENT_NOT_COMPLETEDOrderWebhookUser has cancelled the payment or didn't complete within the session
NAME_NOT_MATCHEDComplianceWebhookUser name on the sender's bank account detail didn't match with TransFi.
BIOMETRICS_CHECK_FAILEDComplianceWebhookUser's device failed the biometric check.
USER_CONSENT_NOT_PROVIDEDComplianceWebhookUser didn’t give gaming order consent within the defined time.
BEHAVIORAL_CHECK_IN_REVIEWComplianceWebhookBiometric check of users device is under review.
BEHAVIORAL_CHECK_FAILEDComplianceWebhookBiometric check of users device has failed.
AMOUNT_MISMATCHOrderWebhookThe payment amount does not match the expected amount.
AUTHENTICATION_FAILEDOrderWebhookUser authentication failed.
BANK_ACCOUNT_ALREADY_IN_USEOrderWebhookThis bank account is already linked to another user.
BANK_UNDER_MAINTENANCEOrderWebhookThere was a technical issue with the bank.
DECLINED_BY_BANKOrderWebhookBank has declined this transaction.
INVALID_ACCOUNT_DETAILSOrderWebhookThe provided account details are invalid.
TRANSACTION_EXPIREDOrderWebhookPayment is not completed within the time.
VALIDATION_FAILEDOrderWebhookValidation has failed for the transaction.
TRANSACTION_FAILEDOrderWebhookTransaction has failed.
OTHERSAnyWebhookAn unexpected error occurred.
INVALID_TOKEN_DETAILSKYCKYC - Same vendorUser email or phone does not match with share token email or phone.
`TOKEN_DATA_INCOMPLETEKYCKYC - Same vendorRequired KYC information is missing in the share token response.
KYC_IMPORT_FAILEDKYCKYC - Same vendorInvalid token format.
KYB_LINK_GENERATION_FAILEDKYBKYBKYB simplified level verification has already been initiated.