Declined Reasons Details

Whenever a validation fails due to inconsistencies in the validation process, the API provides a declined reason to indicate the specific reason for the failure. Each validator has its own list of declined reasons:

Document Validation decline reasons

Declined reason Description
age_above_threshold is used when the person is older than 100 years.
blurry_image is used when the document is illegible.
damaged_document is used when the document was marked as too deteriorated via manual review.
data_not_match_with_government_database is used when the government database check fails.
date_of_birth_does_not_match_with_photo is used when date of birth does not match the age.
document_has_expired is used when the document has expired.
document_is_a_photo_of_photo is used when a document is photo of photo.
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.
document_unregistered is used when the person was not found in the government databases.
empty_input_file when file size is 0 bytes.
face_not_clear when the face in the document is not clear enough.
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.
front_side_document_is_a_photocopy is used when document is a photocopy.
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.
incomplete_document is used when document is incomplete or could not be viewed completely.
inconsistent_delegate_signature is used when delegate's signature does not meet standard conditions.
inconsistent_parent_names is used when initials separating the mother's and father's names is illegible.
invalid_curp is used when the curp does not match with the one generated by us.
invalid_document_number is used when the document number is invalid or has an invalid format.
invalid_format_for_naturally_field is used when the naturally field is different from the standard.
invalid_image_format is used when image format is invalid.
invalid_inputs_to_create_check is used when check inputs are invalid.
invalid_issue_date is used when it is an invalid issue date.
invalid_ministry is used when the ministry on the CNH does not match the active ministry at the time.
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.
invalid_postal_code is used when the postal code is invalid.
irregular_alignments is used the data contained in the document do not match the standards.
irregular_fonts is used when the fonts used in the document are irregular.
manual_review_failed is a manual review failed wildcard.
max_retries_reached is used when reached the retries numbers allow.
missing_accents is used when the document lacks accents or other minor characteristics.
missing_coat_of_arms is used when coat of arms is illegible.
missing_cpf is used when CPF number is illegible
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_agency is used when issuing agency is illegible.
missing_issue_date is used when issue date is missing.
missing_issue_deparment is used when deparment is illegible.
missing_issue_state is used when issuing state is illegible.
missing_legal_institute_perforation is used when the document has irregular perforations.
missing_mrz is used when mrz wasn't found.
missing_municipality_name is used when municipality name 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_neighborhood is used when neighborhood wasn't found.
missing_origin_document is used when the origin where the document has been issued is illegible.
missing_pay_limit_date is used when pay limit date wasn't found.
missing_postal_code is used when postal code wasn't found.
missing_production_data is used when production data wasn't found.
missing_registration_number is used when registration number is illegible.
missing_security_elements is used when the ID card is missing security elements.
missing_state_name is used when state name wasn't found.
missing_street is used when street weren'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.
no_face_detected when a face can't be detected in a document.
ocr_failed is used when the OCR fails.
ocr_no_text_detected when OCR doesn't detect any text on the image.
perforations_illegible is used when the perforations are illegible.
portrait_photo_illegible is used when the portrait photo is illegible.
portrait_photo_is_fake is used when the face picture is modified or fake.
possible_fraud is used when a possible fraud was detected via manual review.
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 couldn't identify the reverse document on image.
reverse_side_document_is_a_photocopy is used when document is a photocopy.
traces_of_tampering is used when the photo have evidence of tampering.
underage is used when the person is under the legal age.
validations_failed is used when one or more declined reasons fails.

Face Recognition Enrollment declined reasons

Declined reason Description
no_face_detected Indicates the face was not detected.
face_in_blocklist Indicates the face being enrolled is in the client's blocklist.
file_format_not_supported Indicates the image file format is not supported.

Face Recognition declined reasons

Declined reason Description
actions_not_in_expected_order Indicates the liveness actions were not performed in the expected order.
faces_are_too_similar Indicates that the same image was used for both the enrollment and validation process.
file_format_not_supported Indicates that the file uploaded has a file format that is not supported.
fraudster_face_match_in_client_collection Indicates that the face matched a fraudster face registered in the Truface client collection.
invalid_file_format Indicates the file uploaded has an invalid format.
liveness_verification_not_passed Indicates liveness actions were not detected.
no_face_detected Indicates no faces were detected in the video.
passive_liveness_verification_not_passed Indicates that the passive liveness verification was not successful.
invalid_video_file Indicates that the file uploaded is not a valid video file.
photo_of_photo Indicates that validation was performed with a photo on other device or it is a document picture.
similarity_threshold_not_passed Indicates the similarity between the face in the video and the one in the picture is less than the defined threshold.
user_face_match_in_client_collection Indicates that the face matched an user face registered in the Truface client collection.

TruFace declined reasons

Declined reason Description
fraudster_face_match_in_client_collection Indicates the face match with client fraudster collection.
fraudster_face_match_in_global_collection Indicates the face match with global fraudster collection.
user_face_match_in_client_collection Indicates the face match with client user collection.

Email Validation declined reasons

Declined reason Description
wrong_verification_code Indicates the verification code provided does not match the one sent to the email.
email_not_valid_verdict Indicates the email provided is considered risky.

Phone Validation declined reasons

Declined reason Description
wrong_verification_code Indicates the verification code provided does not match the one sent to the phone.
phone_number_out_of_coverage Indicates the phone number provided is out of coverage of carrier.

Geolocation declined reasons

Declined reason Description
geolocation_denied Indicates when the process finished because user declines permission for geolocation services.
vpn_detected Indicates when the process finished becausethe system detects the use of a Virtual Private Network (VPN) by the user.

Front-end only declined reasons

Declined reason Description
not_used When the user leaves at the beginning of the process without activating any validation
process_started_late When the process was started 3 minutes before expiring. Most likely the client did not had enough time to finish the flow.
no_document_media_uploaded When the process expires because the user did not upload the document files for the document validation step.
no_face_media_uploaded When the process expires because the user did not upload the the selfie or video for the face validation step.
no_media_uploaded When the process expires because the user did not upload the required file for the step.
not_answered_question When the process expires because the user did not answer a question in the WhatsApp conversation.
manual_review_not_performed When the process expires and the manual review is not completed.
abandoned_without_using_retries When the user abandons the process after making one or more validation attempts, but does not use all retries.
validation_not_finished When the process expires with some validation pending.
validation_expired When we have a validation within the flow that has expired and the process also expires.
user_process_postponed When the process finished because user chooses to postpone a process.