ID Validator FAQ and Troubleshooting

Troubleshooting

• When integrating the ID validator into your iOS or Android application using an embedded browser (e.g. WebView), you must configure your app to forward camera permission requests from the WebView to the native app layer. Without this configuration, the camera permission prompt will be automatically denied, preventing users from completing ID validation. Please refer to the respective documentation of the platform for instructions on how to forward permission requests.

Potential Hardware Issues

• Some external webcams struggle to adjust their auto-focus when an object is held close to the camera. This can cause the system to receive blurry images, preventing proper analysis and potentially creating a "soft-lock" situation. We have implemented countermeasures and provide a seamless device-switching feature that allows users to complete their ID validation on another device. We recommend encouraging users to perform ID validation on their mobile devices, as these typically offer superior camera quality and user experience.

---

Service Status and Error Codes

The ID Validator service emits structured IVC-* status codes across document intake, prevalidation, optical OCR extraction, and verification workflow processing.

Status Code	HTTP Status	Category	Meaning	Customer / Developer Remediation
IVC-0001	400	Request Validation	Missing required query or path parameters	Verify endpoint parameter contract and supply all mandatory parameters (e.g. verification ID, tenant key).
IVC-0003	400	Request Validation	Invalid data passed in request	Ensure payload matches the expected JSON schema and property data types.
IVC-0004	422	Configuration	Inconsistency in template groups	Verify document template group configuration in the Admin Portal.
IVC-0005	409	Conflict	Template group exists with different ID	Check for conflicting template group identifiers.
IVC-0006	422	Configuration	Inconsistency in template configuration	Validate document template bounding boxes, OCR anchors, and expected fields.
IVC-0007	409	Conflict	Template exists with different ID	Ensure template identifiers are unique across tenant configurations.
IVC-0009	400	Request Validation	Missing required payload data in body	Supply all required document images, MIME types, and verification metadata in the request body.
IVC-0010	404	Configuration	Document template not found	Verify the requested template identifier exists and is active.
IVC-0011	404	Not Found	Verification record not found	Verify verification process ID or tracking identifier.
IVC-0013	409	Conflict	Record already exists	A verification or template entity with identical properties already exists.
IVC-0014	403	Authorization	Insufficient privileges	Calling access token lacks required administrative scopes for ID Validator operations.
IVC-0016	404	Configuration	System service settings not found	Tenant ID Validator settings are not configured.
IVC-0017	401	Authentication	Authentication failed	Provide a valid Bearer access token in the Authorization header.
IVC-0018	400	Workflow	No manual review task pending	The verification process is either fully automated or has already completed manual review.
IVC-0019	404	Workflow	Workflow configuration not found	Ensure tenant workflow settings specify an active ID validation workflow.
IVC-0020	404	Configuration	Validation settings not found	Configure ID validation rules in tenant settings before initiating requests.
IVC-0021	422	Validation	Custom attributes validation failed	Verify custom document metadata matches regex and allowed attribute rules.
IVC-0024	409	Process	Process already exists	Initiate verification with a unique transaction or tracking identifier.
IVC-0025	422	Workflow	Workflow configuration invalid	Review validation stages, face match thresholds, and OCR rules in workflow setup.
IVC-0026	422	Configuration	Validation settings invalid	Review confidence thresholds and optical verification rules.
IVC-0028	400	Prevalidation	Field match failed during prevalidation	OCR extracted name, birthdate, or document number does not match user account profile. Re-capture clearly or review account profile data.
IVC-0029	400	Prevalidation	Required prevalidation field missing	Ensure mandatory comparison fields are present in both the user profile and extracted document fields.
IVC-0030	400	Prevalidation	General prevalidation error	Re-capture document image ensuring adequate lighting, sharp focus, and zero glare.
IVC-0031	403	Prevalidation	Prevalidation no longer allowed	The verification session has already transitioned past prevalidation to processing or final review.