This document describes the ID verification workflow powered by AuthenticID, combining biometric facial recognition with secure document validation. Customers are guided through a selfie capture process and prompted to upload a government-issued ID. AuthenticID’s system performs real-time liveness checks, extracts and validates ID data, and compares the selfie to the ID photo for biometric matching.

By integrating this workflow, platforms can ensure regulatory compliance, reduce fraud, and deliver a seamless customer experience. This solution supports KYC/AML standards and is adaptable for onboarding, account recovery, or transaction authentication flows.

Union

Determines the behavior of the action:

When unioned, the document verification will be processed automatically when the unioned action resolves.
When not unioned,Once documents verification completed action will be resolved itself.

Macro level details for how union attribute behaves can be found within the Union documentation.

Features (required)

Name	Type	Description	Rules
title	string	(required) A short description for what document required for verification Examples: "Verify Documents", "Verify Driving License".	MaxLength: 50 MinLength: 3
desktopOnlyMessage	string	A message displayed when the experience is best suited for mobile devices. Examples: "The experience works best on a mobile device.".	MaxLength: 500 MinLength: 10
documentVerificationInfo	string	Information provided to users about document verification steps. Examples: "You will be asked to upload a clear image of your document and follow the on-screen instructions for verification.".	MaxLength: 500 MinLength: 20
configuration	object object	Configuration settings for the Web SDK.	See configuration
accountCode	string	Merchant account code. Examples: "999", "123".	MinLength: 3
postbackURL	string	AuthenticID will provide transaction details using a postback as soon as the transaction is complete. Merchant needs to configure this server. Examples: "https://example.com".
documentType	string	Merchant can define specific document type that need to get verified. Document codes: ('00': 'License Only','01': 'License/Passport', '11': 'Passport Only') Examples: "00", "01", "11".	Possible values: `00`, `01`, `11`.
demoMode	boolean	Merchant can define demoMode flag to define AuthenticID envrionment. For 'true' sandbox envrionment will be used otherwise production envrionment will be used. Examples: true.

configuration

Name	Type	Description	Rules
frontCaptureMode	string	Mode for front document capture.	Possible values: `Auto`, `Manual`.
backCaptureMode	string	Mode for back document capture.	Possible values: `Auto`, `Manual`.
selfieCaptureMode	string	Mode for selfie capture.	Possible values: `Auto`, `Manual`.
enableSelfieCapture	boolean	Flag to enable selfie capture.
enableFarSelfie	boolean	Flag to enable far selfie capture.
backIsBarcodeDetectedEnabled	boolean	Flag to enable far back side barcode.
transactionAttempts	number	Number of transaction attempts allowed.
frontCaptureAttempt	number	Number of front document capture attempts.
backCaptureAttempt	number	Number of back document capture attempts.
enableLocationDetection	boolean	Flag to enable location detection.
requestExpiryTimeInMin	number	Request expiry time in minutes.
transactionExpiryTimeInMin	number	Transaction expiry time in minutes.
showConsent	boolean	If this value is set to true, the consent screen will be shown.
consentNoticeHeading	string	The heading displayed on the consent notice screen.
consentCheckbox	string	The checkbox text displayed on the consent notice screen.
consentNoticeLinkHeading	string	This is the Terms and Conditions link text on the consent notice screen.
consentAgreeStatement	string	The agreement statement displayed on the consent notice screen.
consentNotice	string	This is the consent text on the consent notice screen.
customColor	string	This value is used to color all the buttons in the application. The value should be in CSS3 Hex format.
logo	string	This value displays as the logo on the welcome screen. The value in this field should be a Base64 encoded image file.
homeScreen	string	This value is used to show the background image on the welcome and consent screen. The value in this field should be a Base64 encoded image file.

Example

Below is an example payload for adding an Authentic-id action to a business process or blueprint.

{
    "type": "authentic-id",
    "union": 1,
    "features": {
        "title": "Verify Driving License",
        "desktopOnlyMessage": "The experience works best on a mobile device.",
        "documentVerificationInfo": "You will be asked to upload a clear image of your document and follow the on-screen instructions for verification.",
        "configuration": {},
        "accountCode": "123",
        "postbackURL": "https://example.com",
        "documentType": "11",
        "demoMode": true
    }
}