Comprehensive Guide to User Error Feedback

When integrating with IDWise through the Dynamic SDK or the Get Journey Summary API, developers can encounter a variety of error codes. These codes are essential for identifying specific issues users might face during the ID verification process. Below is an elaborate table that categorizes each error, providing a framework for developers to implement user-friendly feedback mechanisms effectively.

Error Codes: These are the distinct errors identified by the errorUserFeedbackCode attribute in the IDWise Dynamic SDK, or the error_user_feedback_code attribute in the Get Journey Summary API. They serve as the technical markers for problems arising during the verification journey.
Error Title: Presented to the end user through the errorUserFeedbackTitle attribute in the SDK or the error_user_feedback_title attribute in the Get Journey Summary API, this concise description quickly summarizes the error's essence. It offers an immediate understanding of the issue in user-friendly language, avoiding technical complexities.
Error Details: Providing a detailed explanation, the error details are conveyed to the end user via the errorUserFeedbackDetails attribute in the SDK or the error_user_feedback_details attribute in the Get Journey Summary API.
Customization: Both the error title and the error details are fully customizable using IDWise Theme Designer. This flexibility allows developers to tailor the error messages to fit the language, tone, and branding of their application, enhancing the user experience during the verification journey.

Error Feedback Codes, Titles, and Details:

Error Name	Error Code	User Error Title Message	User Error Details	Step Type
Not Physical Document	`feedback_not_physical_document`	"Image not accepted"	"Image does not meet the requirements. Please follow the guidelines."	POI, POA
Document Cropped	`feedback_document_cropped`	"Document Cropped"	"The document is not fully visible."	POI
Face on ID not clear	`feedback_document_face_missing`	"Face not clear"	"The face on the document is not clear"	POI
Failed Document Validation	`feedback_failed_document`	"Image not Clear"	"The submitted image was not clear"	POI, POA
Unrecognised Document	`feedback_unrecognised_document`	"Image not Clear"	"The submitted document could not be recognised	POI, POA
Expired Document	`feedback_document_expired`	"Document Expired"	"Submitted document is expired"	POI
Near Expired Document	`feedback_document_near_expired`	"Near Expired Document"	"Submitted document is nearing expiry"	POI
Not Accepted Document	`feedback_proof_policy_failed`	"Wrong Document"	"Submitted document is not accepted"	POI, POA
Duplicated Document Found	`feedback_duplicated_document_found`	"Duplicate Document"	"You submitted the same document in other steps"	POI, POA
Wrong Side Submitted	`feedback_wrong_side`	"Wrong Side"	"You captured the wrong document side"	POI
Duplicate Side Submitted	`feedback_duplicate_side`	"Duplicate Side"	"You captured the same side twice"	POI
Missing Document Side	`feedback_missing_side`	"Missing Side"	"You have not captured the back of the document."	POI
Outdated Proof of Address	`feedback_outdated_proof_of_address`	"Outdated Document"	"Submitted proof of address is outdated"	POA
Missing Mandatory Fields	`feedback_missing_mandatory_fields`	"Required Information Missing"	"The provided document does not have the required information (e.g. for Proof of Address document, the Address or Full Name field is missing)"	POA
Bad Document Quality	`feedback_document_quality_failed`	"Image not Clear"	"Submitted photo was not clear"	POI, POA
Failed Selfie Liveness	`feedback_selfie_liveness_failed`	""Selfie not Clear"	"Submitted selfie was not clear"	Selfie
Full name mismatch between ID and Proof of address	`feedback_proof_of_address_mismatch`	"Name Mismatch"	"Document data mismatch"	POA
ID Photo doesn't Match Selfie	`feedback_same_person_id_mismatch`	"Unclear ID Face"	"Face on ID not clear"	POI
Selfie doesn’t Match ID Photo	`feedback_same_person_selfie_mismatch`	"Selfie Mismatch"	"Selfie Doesn’t Match ID Photo"	Selfie
Generic Error	`feedback_default`	"Image not Clear"	"Submitted photo was not clear"