Verify ID & Biometrics
Set up a journey to verify an identity document and confirm it with a selfie
This guide walks you through creating a journey that verifies a person's identity document and confirms their identity with a biometric check (selfie with liveness detection).
What you'll build
A 5-step journey:
| Step | Node type | Purpose |
|---|---|---|
| 1 | Start | Welcome screen introducing the verification process |
| 2 | Identity Information | Collect the person's name, date of birth, and other personal details |
| 3 | Identity Document Check | Ask the user to capture their ID card, passport, or residence permit |
| 4 | Biometrics | Take a selfie with liveness detection and match it against the ID photo |
| 5 | End | Confirm the journey is complete and display the result |
Step-by-step setup
1. Create a new journey
- Go to Journey Builder in the left sidebar.
- Click "New journey" to create a new journey.
- Give it a name (e.g. "ID & Biometrics Verification").
You'll see the journey designer with a Start node and an End node already in place.
2. Configure the Start node
Click on the Start node to open its settings. You can customise:
- The welcome title shown to your users
- A description explaining what the journey is about
- An optional logo or image
This is the first screen your users will see when they open the session link.
For more details, see Start step.
3. Add an Identity Information step
Click the "+" button between Start and End to add a new step, then select Identity Information.
Configure the fields you want to collect:
- Choose Natural Person as the entity type
- First name and Last name (required for matching against the ID document)
- Date of birth (recommended for additional cross-checking)
The data entered here will be compared against what the AI extracts from the identity document.
For more details, see Identity Information step.
4. Add an Identity Document Check step
Add another step after Identity Information and select Identity Document Check.
Configure the accepted document types:
- ID cards β select the countries you want to accept
- Passports β ICAO-compliant passports are supported for most countries
- Residence permits β if relevant to your use case
Set the behaviour on failure β choose whether to block the journey, show an alert, or allow the user to retry.
For more details, see Identity Document Check step.
5. Add a Biometrics step
Add a step after the Identity Document Check and select Biometrics.
This step will:
- Ask the user to take a selfie using their device camera
- Run liveness detection to ensure the user is physically present
- Compare the selfie against the photo on the identity document
No additional configuration is needed β the step uses the identity document from the previous step automatically.
For more details, see Biometrics step.
6. Configure the End step
Click on the End node to customise the final screen:
- Set a thank you message for the user
- Optionally add a redirect URL to send the user back to your application
For more details, see End step.
7. Publish and test
- Click "Publish" to save and activate the journey.
- Go to Analysis β By session and create a new session using this journey.
- Scan the QR code or open the session link to test it yourself.
What happens next
Once a user completes the journey:
- Results appear instantly in the back office under Analysis β By session
- The AI verdict is displayed along with extracted data and fraud checks
- You can review, approve, or reject the session manually
- If you've set up a webhook, your system is notified automatically
See Journey Sessions (Back Office) and Analytics for details on reviewing results.
Updated 2 days ago
