Valify Error Codes
In case HTTP error code 422 was returned, a custom error code is usually found in the response body. The below table consists of all the custom error codes that might return from our services APIs and the recommended actions for this error.
OCR error codes
4001
Error in Prediction Process
Please re-capture the image.
4004
Document is not clear
Please make sure the text is clear in the image.
4201
Unsupported Document
Please enter a supported document.
4204
Error in Extracting Information
Please make sure that the text is clear in the image.
5009
Un processable Data
Please provide valid data
5018
Transaction not found.
Check the Transaction ID/token sent in the request.
Face Match
4205
Couldn't Extract Facial Features
Please make sure that there is a face in the image.
4206
Face Match Error
Please make sure to have only one face in the image.
4207
Face Match Error
Please make sure that the image is clear.
5015
Error to be reported
Contact server admin
5018
Transaction not found.
Check the Transaction ID/token sent in the request.
5019
No image found for this transaction.
Check the transaction referenced is successful, and has an image.
5038
Referenced transaction is invalid.
Please make sure the transaction ID provided is valid.
Liveness
5018
Transaction not found.
Check the Transaction ID/token sent in the request.
5020
Transaction already processed
There is no further action needed for this transaction.
OTP
5004
Unlinked phone number
Please enter a phone number linked to the passed National ID.
5005
Wrong OTP
Please make sure the OTP passed matches the one sent by the service provider. Try again later.
5006
Expired OTP
Please re-generate an OTP and try again.
Sanction Shield
5048
Not subscribed to list
wrong list name - Invalid Sanction list
400
Using Multiple names or document numbers
Multiple names or document numbers detected.
Miscellaneous/Deprecated Error codes
Code
Meaning
Actions
4002
Error in Prediction Process
Please make sure the document is clear in the frame.
4003
Error in Prediction Process
Please make sure the document is clear in the frame.
4005
Error in The Gender Prediction Process
Please recapture the image.
4006
Error in Prediction Process
Please recapture the image.
4007
Error in the Face Match Process
Please recapture the image.
4008
Error in the transliteration process
Please make sure to send a valid string.
4202
Image Not Well Oriented
Please make sure that the image is clear.
4203
Document Validation Error
Error, Please make sure the document is in a good lighting condition.
4208
Transliteration Error
Please make sure to send a valid string.
4210
Error, Please make sure the document is fully visible and not damaged or broken.
The document needs to be in good condition to be accepted.
4211
Error, Please make sure to submit a physical document.
Please recapture the image making sure all information on the National ID is clear.
4301
Document Expired
Make sure the expiry date of the submitted document has not passed.
4714
Maximum image size exceeded.
Make sure each provided image does not exceed the 5MB limit.
4715
Maximum image resolution exceeded.
Make sure each provided image does not exceed the 25 Million pixel limit.
5000
Invalid Bundle Key
Please re-enter your bundle key correctly.
5001
Insufficient Balance
Please recharge your bundle and try again.
5002
Exceeded number of trials
Number of trials exceeded the limit. Try again later.
5003
Unregistered Service
Make sure the service being called is registered in your bundle.
5007
Front and Back NID Mismatch
Please make sure to use the same ID for both sides.
5008
Base64 Encoding Error
Please provide a valid base64 encoded image.
5009
Unprocessable Data
Please provide valid data.
5010
Disabled Bundle
The bundle has been disabled, please contact the server admin for re-activation.
5011
Duplicate Identifier
Please provide valid data.
5012
Invalid Session ID
Please make sure the session ID passed is valid.
5013
KYC has been already performed
The user can't perform KYC twice, please contact the admin for any inquires.
5014
This user is sanctioned
The user is prohibited from performing this service, please contact the admin for any inquires.
5021
Transaction is still in progress.
Please wait until the transaction is completed.
5039
Insufficient quota.
Please recharge your quota and try again.
5040
Transaction Combination not found.
Please make sure the combination ID provided is valid.
5041
Bundle is not supported.
Please contact the system administrator.
5043
Maximum image size exceeded.
Make sure each provided image does not exceed the 5MB limit.
5044
Maximum image resolution exceeded.
Make sure each provided image does not exceed the 25 Million pixel limit.
Last updated