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.

PreviousError Codes NextHTTP Codes

Last updated 3 months ago

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.

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.

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.

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.