- Required inputs: Primary document front side image.
- Optional inputs: Primary document back side image.
- Outputs: Document classification, extracted document data, anchor portrait image, and document validation results.
Capabilities
The module returns capabilities grouped into four areas: classification, image quality, extraction, and authentication.Classification capabilities
Classification identifies the document and returns its type and issuing origin. The module returns the following classification values:Image quality checks
The module runs image quality checks on both the front and back sides of the document. Each check returns one of five values:Front side checks
The following checks run on the front side image of the document:Back side checks
The following checks run on the back side image of the document, when a back image is provided:Extraction capabilities
Extraction reads the required fields from the document and derives related values, such as the subject’s age and expiry status. The module returns the following extraction values:Authentication capabilities
Authentication assesses whether the document is genuine and whether it shows signs of tampering. The module returns the following authentication values:Default outcomes
The outcome logic spans all three phases. Classification outcomes are evaluated first, then authentication/tamper risk outcomes, then extraction outcomes.Input payload
The following is a sample payload used to submit document images to the Document Verification module for processing.JSON
Sample response
The following is a sample response from the Document Verification module.JSON
Document Verification
Document Verification consolidates Document Classification, Document Extraction, and Document Authentication into a single module dispatch. The single module returns the combined classification result, extracted fields, and authentication/tamper checks in one journey segment.Capabilities
Default outcomes
The following default outcomes are available for evaluation and routing in the Journey builder.Input payload
The following is a sample payload used to submit data to the Document Verification module for processing.JSON
Sample response
The following is a sample response returned by the module.JSON
Document tampering result
Returns the result for document tampering.Document authentication result
Returns the result of the document authentication.Anchor image extracted
Indicates whether the anchor (portrait) image was successfully extracted from the document. When false, downstream facematch can be skipped as there is no anchor image to compare against.Days since expiry
Provides the number of whole days since the document’s Expiry Date. Returns 0 when the document has not expired, or when the Expiry Date could not be determined. Important: when authoring a threshold rule, always combine this with Document Expiry Status = Expired, because Not Expired and Undeterminable documents also return 0 — a rule on Days Since Expiry alone (for example, <= 730) would match those too. Example: ‘Document Expiry Status is Expired AND Days Since Expiry <= 730’ accepts only documents that expired within a 730-day / ~2-year grace period.Calculated age
Provides a calculated Age (in years) based on date of birth and current date.Document expiry status
Provides the document’s Expiry status.Document extraction result
Provides an extraction result based on the customer’s required extraction data (as defined in configuration).Back side full document in view check
Returns Back Side Full Document In View Check resultFront side full document in view check
Returns Front Side Full Document In View Check resultBack side colour check
Returns Back Side Colour Check resultFront side colour check
Returns Front Side Colour Check resultBack side blur check
Returns Back Side Blur Check resultFront side blur check
Returns Front Side Blur Check resultBack side glare check
Returns Back Side Glare Check resultFront side glare check
Returns Front Side Glare Check resultBack side low resolution check
Returns Back Side Low Resolution Check resultFront side low resolution check
Returns Front Side Low Resolution Check resultCountry name
Returns the full country nameDocument country code
Returns the country code in ISO3 format, eg. GBR.State name
Returns the state name if applicable.Document type
Returns the type of document, for example: Passport, Identification Card, etc.Document classification result
Overall Classification Result for Classification ModuleRelated guides and tutorials
The following guides and tutorials use this module or explain how to configure it.Identity document verification
Verify a customer’s identity document.
How to combine document and biometric modules
Ordering documents and biometrics.