> For the complete documentation index, see [llms.txt](https://valify.gitbook.io/valify-ios-sdk-documentation/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://valify.gitbook.io/valify-ios-sdk-documentation/biometrics-sdk-recommended/overview.md).

# Overview

Stop spoofing, not users.VIDV Biometrics delivers face liveness detection and biometric verification for banks, fintech platforms, and digital onboarding teams — strong anti-spoofing protection that never slows your users down.

Guided capture, end-to-end encrypted sessions, and optional face matching against a document or reference photo — all through a single, simple API you can integrate in minutes.

## Why VIDV Biometrics

|                         |                                                                                                  |
| ----------------------- | ------------------------------------------------------------------------------------------------ |
| **Real-time liveness**  | Passive and active checks confirm a live face is present — not a printout, screen, or replay.    |
| **Optional face match** | Match the live selfie to a document face or reference image in the same session.                 |
| **Production-ready UX** | Tutorial, voice guidance, haptics, timers, and clear retries — designed for completion rates.    |
| **Brandable UI**        | Theme colors, logos, light/dark capture modes, and white-label options.                          |
| **Secure by design**    | End-to-end encrypted session traffic with token-based access.                                    |
| **Easy to integrate**   | Configure with a builder, start from any Activity, get typed success / failure / exit callbacks. |

## Core capabilities

### Liveness detection

* **Passive liveness** — user holds still while the SDK captures a verified frame sequence
* **Active liveness** — guided head movements (look left / right / up / down) for stronger assurance
* **Flexible flows** — passive-only for speed, or passive + active for higher assurance
* Configurable action count, timers, and direction exclusions

### Face matching

* Match against a **reference face image**, or
* Match against an **OCR / document transaction** from your Valify pipeline
* Optional same-session constraint when linking to prior document capture

### Capture experience

* On-device face guidance with clear “place face / keep still” feedback
* Multilingual UI (**English, Arabic, French**)
* Voice-over and haptic feedback (optional)
* Bright or dark UI modes for different lighting environments
* Smart retries and optional second-chance fallback

### Compliance & review

* **Audit mode** for no-face / edge sessions — flag sessions that need human review
* Session flags returned to your app (`auditRequired`, `auditCaseCreated`) for downstream workflows

### Security & control

* Encrypted API session after key exchange
* Custom headers and SSL certificate pinning support
* Optional device / location metadata collection
* Clean result model: success, service failure, user exit, or builder validation error

## Flows

| Flow                              | What it does                                              | Best for                                  |
| --------------------------------- | --------------------------------------------------------- | ----------------------------------------- |
| **Passive liveness**              | Still-face capture only, then verify                      | Fast verification, lower friction         |
| **Active liveness**               | Passive + guided head movements                           | Higher assurance, stronger anti-spoofing  |
| **Biometrics (liveness + match)** | Liveness plus face match to image or document transaction | Full identity confirmation in one session |