Valify Error Codes

In case HTTP error code 422 is 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

Code	Meaning	Actions
4001	Error in Prediction Process	Please re-capture the image.
4002	Error in Text Detection	Please make sure all document details are clear. Please make sure there is no glare, no shadows, and all details are in focus and try again.
4003	Error in Prediction Process	Please re-capture the image. If the error persists, please contact us
4004	Text fields are not clear	Please make sure all document details are clear. Please make sure there is no glare, no shadows, and all details are in focus and try again.
4005	Error in The Gender Prediction Process	Please re-capture the image.
4006	Error in Prediction Process	Please re-capture the image.
4201	Incorrect document type.	Please enter a supported document.
4202	Image Not Well Oriented.	Please re-capture the image making sure all information on the document is clear and displayed correctly
4203	Document Validation Error	Please recapture the image making sure all information on the document is clear
4204	Error in Extracting Information.	Please make sure all document details are clear. Please make sure there is no glare, no shadows, and all details are in focus, and try again.
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.
4301	Document expired	Please make sure the document is still valid
5007	Two different national IDs used.	Please use the same national ID for both the front and back sides and try again.
5042	Document not physical	Please make sure that the document provided is a physical document.
5049	Two different national IDs found.	Please use the same national ID for all the trials and try again.
5050	Serial number mismatch	Two different serial numbers found. Please use the same national ID for all the trials and try again.
5051	Invalid PDF Format.	Please use a Valid PDF Format.
5052	Maximum file size exceeded.	Please use a file that does not exceed the 10MB limit

Face Match

Code	Meaning	Actions
4007	Error in the Face Match Process	Please recapture the image.
4205	No Face detected	Please make sure that there is a face in the image.
4206	Multiple Faces detected	Please make sure to have only one face in the image.
4207	Face is unclear.	Please make sure that there is a clear face in the image.
5038	Referenced transaction is invalid.	Please make sure the transaction ID provided is valid.

Liveness

Code	Meaning	Actions
5020	Transaction already processed	There is no further action needed for this transaction.
4011	Error in detection	Please re-capture the image.
4212	Error in detection	Please re-capture the image.

OTP

Code	Meaning	Actions
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.
5057	Temporary OTP Block	Please wait at least one minute before requesting another OTP.

Sanction Shield

Code	Meaning	Actions
5014	Sanctioned person	This person is banned from receiving financial services.
5048	Not subscribed to list	wrong list name - Invalid Sanction list

Transliteration

Code	Meaning	Action
4008	Error in the transliteration process	Please make sure to send a valid string.
4208	Transliteration Error	Please make sure to send a valid string.

Watermark

Code	Meaning	Action
5022	Watermark batches is insufficient	Number of watermark batches is insufficient
5023	Watermark batches are already processed.

Root of Trust

Code	Meaning	Action
5030	Root of trust failed.	Please try again.
5031	Document data is not valid.
5032	Person records not found.
5033	Person has not issued an ID document.
5034	Person is deceased.
5035	Person's information is inaccessible.
5036	Person has been sanctioned.
5037	Person's document is expired.
5038	Referenced transaction is not valid.	Please use a valid transaction.
5040	Transaction combination not found.
5045	National ID number is incorrect.
5047	Submitted document may not be the latest.

Digital Contract

Code	Meaning	Action
5059	Failed to validate session.	Please make sure you are using a valid bundle session Id.
5060	Failed to save to digital registry.	Failure while storing in digital registry.

General/Integration Error

4209	Wrong Document type.	Please make sure to upload a right document type.
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.	You are not registered to this service. To register to this service, please contact the server admin.
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.
5015	Error to be reported.	Contact server admin
5018	Transaction not found.	Please make sure the transaction ID or token used is correct and try again.
5019	No image found for this transaction.	Please try again with a valid transaction.
5021	Transaction is still in progress.	Please wait until the transaction is completed.
5024	User is deactivated
5025	Session is not found.
5026	Session has already ended.
5027	Session has already been created.
5028	Wrong Key format.	Please check the format of the provided key
5029	Session Expired.	Unfortunately, your session has expired. Please try again.
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.
5046	Invalid Extra Category	Access to this extra category is not granted. Please contact us.
5053	Unsupported file type.	Please use a valid file type.
5054	Service Deprecaed.	This service has been deprecated. For support, please contact
5055	Maximum number of fields exceeded.	Please review your input and ensure that you are not including more fields than allowed by the admin.
5058	User info has already been created.	User info has already been logged for this session.
5061	Device blocked.	The device is currently blocked due to repeated failed transactions , Please try again after.