Skip to main content

Liveness Verification

The Liveness Verification step ensures that the person completing the verification is a real human and matches the portrait in their identity document. This step must be linked to a Document Verification step.

Overview​

The liveness check performs active liveness detection using facial recognition technology to:

  1. Verify that a live person is present (not a photo, video, or mask)
  2. Match the live portrait against the portrait extracted from the identity document
  3. Optionally perform biometric uniqueness checks to prevent duplicate identities (ask the support to enable the functionality in case of need)

How It Works​

  1. Prerequisites: A Document Verification step must be completed first to extract the portrait image from the identity document
  2. User Flow: The user is prompted to position their face in the camera frame and follow on-screen instructions
  3. Active Liveness: The system performs active liveness detection to ensure a real person is present
  4. Face Matching: The live portrait is compared against the portrait from the document
  5. Validation: The system validates that the match score meets the configured threshold

Customize Settings​

General Details​

  • Name: The name of the flow step. It will be used to identify the step in the flow.
  • Document Step: The Document Verification step that this liveness check is linked to. The liveness check will use the portrait extracted from the document in this step for comparison.
  • Success Button Label: A custom label for the Continue button that is shown once the step is completed.

Thresholds​

  • Minimum Portrait Match Percent: The minimum similarity score (0-100%) required between the live portrait and the document portrait. Default: 75%

    • Higher values increase security but may result in more false rejections
    • Lower values are more permissive but may reduce security

  • Biometric Match Percent: The minimum similarity score required for biometric uniqueness checks when biometric checking is enabled. Default: 75% (ask the support if you need to change the value)

Best Practices​

For End Users​

The liveness check works best when users:

  • Use good lighting: Ensure the face is well-lit without harsh shadows
  • Find a neutral environment: Use a plain background without distractions
  • Position properly: Keep the face centered in the frame
  • Remove accessories: Take off glasses, hats, or masks that might obscure the face

Common Issues​

Low Match Score​

If users frequently fail the liveness check:

  • Check if the portrait in the document is clear and recent
  • Verify that lighting conditions are adequate
  • Ensure users are following the on-screen instructions

Technical Details​

The liveness verification step:

  • Uses active liveness detection (user interaction required)
  • Performs face matching using advanced biometric algorithms
  • Stores the live portrait securely in the user's vault
  • Can trigger biometric uniqueness checks across on a per-flow basis