Document Validation Declined Reasons

Whenever a Document Validation fails due to inconsistencies in the document data or presentation, a declined reason is provided to indicate the specific reason. Here’s a list of declined reasons by country:

Brazil

Declined reason	Description
portrait_photo_illegible	is used when the portrait photo is illegible
perforations_illegible	is used when the perforations are illegible
missing_issue_state	is used when issuing state is illegible
missing_issue_agency	is used when issuing agency is illegible
missing_issue_deparment	is used when deparment is illegible
missing_coat_of_arms	is used when coat of arms is illegible
missing_registration_number	is used when registration number is illegible
inconsistent_parent_names	is used when initials separating the mother's and father's names is illegible
missing_cpf	is used when CPF number is illegible
missing_origin_document	is used when the origin where the document has been issued is illegible
date_of_birth_does_not_match_with_photo	is used when date of birth does not match the age
inconsistent_delegate_signature	is used when delegate's signature does not meet standard conditions
blurry_image	is used when the document is illegible
portrait_photo_is_fake	is used when the face picture is modified or fake
incomplete_document	is used when document is incomplete or could not be viewed completely
irregular_alignments	is used the data contained in the document do not match the standards
missing_accents	is used when the document lacks accents or other minor characteristics
missing_security_elements	is used when the ID card is missing security elements
irregular_fonts	is used when the fonts used in the document are irregular
traces_of_tampering	is used when the photo have evidence of tampering
missing_legal_institute_perforation	is used when the document has irregular perforations
invalid_format_for_naturally_field	is used when the naturally field is different from the standard
invalid_ministry	is used when the ministry on the CNH does not match the active ministry at the time

Other countries (Chile, Colombia, Costa Rica, Mexico, and Peru)

Declined reason	Description
age_above_threshold	is used when the person is older than 100 years.
invalid_inputs_to_create_check	is used when check inputs are invalid
front_side_document_is_a_photocopy	is used when document is a photocopy
document_has_expired	is used when the document has expired.
document_is_a_photocopy	is used when document is a photocopy
document_not_recognized	is used when a document is not recognized in the picture.
reverse_side_document_is_a_photocopy	is used when document is a photocopy
face_not_detected	is used when the face was not found in the document.
front_document_not_found	when the detection model couldnt identify the front document on image
data_not_match_with_government_database	is used when the government database check fails.
document_unregistered	is used when the person was not found in the government databases.
government_database_unavailable	is used when the government database is unavailable.
identity_belongs_to_dead_person	is used when the government validation found identity is of a dead person.
image_face_validation_not_passed	is used when the image analysis doesn't pass.
image_text_validation_not_passed	is used when the image analysis doesn't pass.
invalid_curp	is used when the curp does not match with the one generated by us.
invalid_issue_date	is used when it is an invalid issue date.
invalid_mrz	is used when the MRZ does not match with the info in the labels.
invalid_mrz_format	is used when the MRZ format is invalid.
manual_review_failed	is a manual review failed wildcard
missing_date_of_birth	is used when date of birth wasn't found
missing_document_number	is used when doc number is missing
missing_expiration_date	is used when the expiration date is not found.
missing_gender	is used when gender wasn't found.
missing_inputs_to_create_check	is used when inputs are missing
missing_issue_date	is used when issue date is missing
missing_mrz	is used when mrz wasn't found.
missing_names	is used when names weren't found.
missing_nationality	is used when mrz wasn't found.
missing_national_registrar	is used when national registrar wasn't found.
missing_production_data	is used when production data wasn't found.
missing_text	is used when some field needed in validation cannot be found.
national_registrar_inconsistency	is used when national registrar has inconsistency with document issue date.
ocr_failed	is used when the OCR fails.
production_data_inconsistency	is used when production data has inconsistency between document data.
production_data_invalid_format	is used when production data has invalid format.
reverse_document_not_found	when the detection model couldnt identify the reverse document on image
underage	is used when the person is under the legal age.
validations_failed	is used when one or more declined reasons fails.

Front-end only declined reasons

Declined reason	Description
canceled	The user decides to cancel the process
unwanted_camera_permissions	The user does not accept camera permissions, which does not allow to continue with the process.
unknown_how_activate_camera_permissions	The user does not know how to activate the camera permissions of the device.
camera_permission_option_no_appear	The option to activate camera permissions does not appear on the screen.