FaceMatchValidator — Usage Guide

This component provides client-side facial verification by comparing the face from an ID document with a selfie image.

It exposes two Actions for different input formats:

• VerifyFaceMatchBase64

• VerifyFaceMatchBinary

Both return a Boolean value indicating whether the facial match was successful.

✅ Prerequisites — Script Loading (Required)

Before using any FaceMatchValidator Actions, the required JavaScript libraries must be loaded on the page.

You can do this in two ways:

Option 1 — Load scripts in the same screen/block where the component is used

Recommended when you want the libraries to be loaded only when necessary.

Option 2 — Add the FaceMatchValidator helper block to your screen

The block includes script loading logic and usage instructions.
It is placed under a True branch, so it does not affect screen behavior and can be safely added or removed.

⚠️ If the scripts are not loaded before calling the Actions, facial verification will fail.

VerifyFaceMatchBase64

Compares a selfie with the front image of an ID document using Base64-encoded images.

Parameters

VerifyFaceMatchBinary

Compares a selfie with the front image of an ID document using Binary Data images.

Parameters

Threshold Guidelines

The Threshold defines how similar the two faces must be to be considered a valid match.

Best Practices

• Ensure good lighting when capturing selfies

• Avoid glare or shadows on document photos

• Use clear front document images with visible portrait

Common Failure Reasons

• No face detected in selfie

• No face detected in document

• More than one face detected

• Distance above threshold