Liveness
If you wish to request a liveness check from the user, this section provides you with all the details to complete this. Each check will provide a report of the result from the liveness check.
Here we describe:
- What is a liveness check.
- Types of liveness.
- The outcome and recovery suggestions.
A liveness check is to assess whether the document scan is being performed by a real person, and not someone wearing a mask or an automated system. Whilst the liveness test is being performed, Yoti will take 3 images of the user.
Active liveness
Static liveness
You must provide the maximum number of retries your users can have, before the liveness is failed. There must be a minimum of 1 attempt. Yoti recommends 3 attempts as a max retry number.
| Name | Resources | Manual check available |
|---|---|---|
| Liveness | 1x Liveness Resource | ❌ |
Liveness types
Yoti provides two types of liveness - Active (Zoom) and Passive (Static). Depending on your type of integration, you might find one of the liveness options more suitable.
- Active liveness requires the user to move closer to further away from the screen while centring their face within an Oval. On a Mobile device the user is expected to move their phone closer to their face
- Passive liveness requires a single image of the user, captured within an overlay presented on screen
Enhance your check
Add these features to enhance your check for better results
| Name | Description | Resources | Manual check available |
|---|---|---|---|
| Mobile hand off | Start your session in web and allow the user to smoothly move to mobile. | N/A | N/A |
| Liveness attempts | Increase the number of liveness attempts you allow a user to try. | N/A | ❌ |
Common causes for liveness failure include (with suggestions to improve):
- Lighting that's too dark or bright - Change position to have clear light in front and reduce background lighting
- Geometric backgrounds - Perform the liveness in front of a plain background
- Glare - Make sure your camera lens is clear and avoid having reflective surfaces in frame
- Angle - Ensure you're level with the camera and looking straight
- Eye contact - Try to look at or near the camera and that your eyes are visible.
User Flow
- The user will be prompted to provide their consent.
- Yoti will provide an overview of what the liveness entails. There is a 'more about verification' screen which users can also read further.
User flow: Pre read for Active liveness
User flow: Pre read for Passive liveness
- The user will be presented with an oval or face-shaped overlay depending on the liveness type. They will need to position their face correctly for an automatic scan. If this is not possible, they have to press i'm ready.
User flow: Active liveness start
User flow: Passive liveness start
We will provide in-session feedback during the liveness flow.
- The user will move forwards/backwards or align their face until liveness is complete. They will be presented with a complete screen.
User flow complete screen
At this point you can redirect the user to a success URL / Error URL.