Error Codes

List of Error Codes

Error Code	HTTP Status Code	Error Type	Endpoint	Descriptions
`CUSTOMER_NOT_FOUND`	`404`	Authentication	All	The username and password used for authentication could not be found in the system.
`UNAUTHORIZED_CUSTOMER`	`401`	Authentication	All	The MID header is either empty or could not be found in the system.
`INVALID_ARGUMENTS`	`400`	External	All	Invalid arguments provided in the request.
`MISSING_ARGUMENTS`	`400`	External	All	Required arguments are missing from the request.
`CURRENCY_NOT_FOUND`	`404`	Rates	All	The requested currency is not supported or not found.
`QUOTES_LIMIT_ERROR`	`400`	Rates	Exchanges Rates, Order	The provided amount is not in the limits for selected trading pair.
`QUOTES_EXPIRED`	`400`	Rates	Exchanges Rates, Order	The provided quotes have expired and are no longer valid.
`CONFLICT`	`409`	User	User	The user is already available in the system.
`USER_NOT_FOUND`	`404`	User	User	The specified user could not be found in the system.
`AGE_LIMIT_ERROR`	`400`	User	User	The individual user age should be between the limits.
`FILE_REQUIRED`	`400`	Invoice	Order	A invoice is required to perform transaction.
`INVALID_PAYMENT_CODE`	`400`	Order	Order	The payment code provided is invalid or incorrect.
`INSUFFICIENT_BALANCE`	`400`	Order	Order	The account has insufficient balance to complete the transaction.
`INVALID_QR_STRING`	`400`	Order	Order	QR String Validation Error
`QR_DETAILS_FETCH_FAILED`	`400`	Order	Order	Failed to fetch QR details from PMS
`INVALID_QR_DETAILS`	`400`	Order	Order	Invalid QR code details received. Merchant name is not available in QR String.
`INVALID_QR_AMOUNT`	`400`	Order	Order	Invalid amount provided. Please ensure the amount is neither 0 or matches the qrCode amount.
`EMAIL_VERIFICATION_FAILED`	`409`	Compliance	User, Order	Email verification is failed and cannot be used for contact creation. Please contact support for further assistance.
`EMAIL_UNDER_MANUAL_REVIEW`	`409`	Compliance	User, Order	Email is under manual review. Please wait 24-48 hours or contact support.
`DEVICE_UNDER_MANUAL_REVIEW`	`400`	Compliance	Order	Please 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_FAILED`	`400`	Compliance	Order	Please note the contact is disabled due to device & biometric check failed. Please contact support for further assistance.
`KYT_UNUSUAL_BEHAVIOR_MANUAL_REVIEW`	`400`	Compliance	Order	Please 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_BLOCK`	`400`	Compliance	Order	Please 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_BEHAVIOR_PERM_BLOCK`	`400`	Compliance	Order	Please 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_REQUIRED`	`400`	Compliance	Order	Limit breached – Standard KYC is required.
`ENHANCED_KYC_REQUIRED`	`400`	Compliance	Order	Limit breached – Enhanced KYC is required.
`BASIC_SCREENING_IN_PROGRESS`	`400`	Compliance	Order	User creation is in progress. User's Basic KYC is pending.
`BASIC_SCREENING_REJECTED`	`400`	Compliance	Order	User KYC has been rejected.
`KYC_EXPIRED`	`400`	Compliance	Order	User KYC document has expired.
`RESUBMISSION_REQUIRED`	`400`	Compliance	Order	User KYC failed – Please resubmit your KYC.
`MAXIMUM_LIMIT_BREACHED`	`400`	Compliance	Order	Maximum transaction limit reached. No further orders will be accepted for this user.
`RESTRICTED_ACCESS`	`403`	Order	Order	The user is not allowed to do transaction.
`INTERNAL_SERVER_ERROR`	`500`	Internal	System	An internal server error occurred while processing the request.
`SYSTEM_ERROR`	`500`	Internal	System	An internal system error occurred.
`PAYMENT_NOT_COMPLETED`	`N/A`	Order	Webhook	User has cancelled the payment or didn't complete within the session
`NAME_NOT_MATCHED`	`N/A`	Compliance	Webhook	User name on the sender's bank account detail didn't match with TransFi.
`BIOMETRICS_CHECK_FAILED`	`N/A`	Compliance	Webhook	User's device failed the biometric check.
`USER_CONSENT_NOT_PROVIDED`	`N/A`	Compliance	Webhook	User didn’t give gaming order consent within the defined time.
`BEHAVIORAL_CHECK_IN_REVIEW`	`N/A`	Compliance	Webhook	Biometric check of users device is under review.
`BEHAVIORAL_CHECK_FAILED`	`N/A`	Compliance	Webhook	Biometric check of users device has failed.
`AMOUNT_MISMATCH`	`N/A`	Order	Webhook	The payment amount does not match the expected amount.
`AUTHENTICATION_FAILED`	`N/A`	Order	Webhook	User authentication failed.
`BANK_ACCOUNT_ALREADY_IN_USE`	`N/A`	Order	Webhook	This bank account is already linked to another user.
`BANK_UNDER_MAINTENANCE`	`N/A`	Order	Webhook	There was a technical issue with the bank.
`DECLINED_BY_BANK`	`N/A`	Order	Webhook	Bank has declined this transaction.
`INVALID_ACCOUNT_DETAILS`	`N/A`	Order	Webhook	The provided account details are invalid.
`TRANSACTION_EXPIRED`	`N/A`	Order	Webhook	Payment is not completed within the time.
`VALIDATION_FAILED`	`N/A`	Order	Webhook	Validation has failed for the transaction.
`TRANSACTION_FAILED`	`N/A`	Order	Webhook	Transaction has failed.
`OTHERS`	`N/A`	Any	Webhook	An unexpected error occurred.
`INVALID_TOKEN_DETAILS`	`422`	KYC	KYC - Same vendor	User email or phone does not match with share token email or phone.
`TOKEN_DATA_INCOMPLETE`	`422`	KYC	KYC - Same vendor	Required KYC information is missing in the share token response.
`KYC_IMPORT_FAILED`	`400`	KYC	KYC - Same vendor	Invalid token format.
`KYB_LINK_GENERATION_FAILED`	`400`	KYB	KYB	KYB simplified level verification has already been initiated.
`BASIC_KYB_NOT_APPROVED`	`400`	KYB	KYB	User has not completed basic KYB
`STANDARD_KYB_NOT_APPROVED`	`400`	KYB	KYB	User has not completed standard KYB
`STANDARD_KYB_ALREADY_APPROVED`	`400`	KYB	KYB	User has already completed standard KYB
`ADVANCED_KYB_ALREADY_APPROVED`	`400`	KYB	KYB	User has already completed advanced KYB
`USER_BLOCKED_OR_REJECTED`	`400`	KYB	KYB	User KYB is blocked or rejected
`ADDRESS_RESUBMISSION_REQUIRED`	`400`	User	User	The provided address is not valid and needs to be resubmitted with correct information.