# Introduction

**Web SDK** of the NV Global computer vision platform is a ready‑to‑use KYC widget for web applications. It runs on top of your page and guides the user through all steps of identity verification: photographing the document, taking a selfie (or selfie with a document), anti‑fraud checks, and sending the result to your backend.

> **Platform support.** The widget works in all modern browsers on desktop and mobile devices (iOS/Android). Only camera access is required for the selfie/document capture stage.

***

## What the process looks like on a phone (step by step)

Below is a typical UX for the scenario “passport + selfie with document”. You can enable/disable individual steps in your schema.

### 1) Start via QR code or link

The user opens the page with the start screen and scans the QR code (or follows the provided link). The widget supports selecting the interface language.\
![Start screen with QR code](https://1453876250-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRr3zB0xucM3fgCViuJqz%2Fuploads%2FUhgsIoBqewDHpTqWqXrv%2F01-qr.jpg?alt=media\&token=64f2d591-048f-4b89-8467-8d95631fe373)

### 2) Widget loading

After following the link, the KYC widget loading screen appears.\
![KYC widget loading screen](https://1453876250-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRr3zB0xucM3fgCViuJqz%2Fuploads%2FDzb9rIa7VRqpE5QcTARM%2F02-loading.jpg?alt=media\&token=cec8c9e0-d5cc-4d18-85e8-147ad5270b53)

### 3) Short instructions before starting

The widget explains what will happen next and asks the user to prepare the document and ensure good lighting.\
![Instructions before starting](https://1453876250-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRr3zB0xucM3fgCViuJqz%2Fuploads%2FXqevRzSWWtGyL6RXjArG%2F03-instructions.jpg?alt=media\&token=e200c5ea-dc0f-44c1-ae47-5a77733f7bf5)

### 4) Document capture guidance

The widget explains which document needs to be photographed and how to position it: the document must fully fit inside the frame without cutting off edges.\
![Document capture guidance](https://1453876250-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRr3zB0xucM3fgCViuJqz%2Fuploads%2Fx4diI9w51WVdKelRsiI4%2F04-doc-guide.jpg?alt=media\&token=d7ec124f-05e4-4a53-be36-09d7dfcf3bf3)

### 5) Camera access permission

The browser will ask for permission to use the camera — **this must be granted**, otherwise capturing will be unavailable.\
![Camera permission request](https://1453876250-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRr3zB0xucM3fgCViuJqz%2Fuploads%2FrdcwTI14MfDWTdFBhdze%2F05-permissions.jpg?alt=media\&token=960c76a7-cf2b-4480-b4f6-dd1946cd5b56)

### 6) Document capture

Take a photo of the document. It must be **fully visible**, without obstructions (fingers/objects), without glare or heavy blur; text fields must be readable.\
![Document capture](https://1453876250-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRr3zB0xucM3fgCViuJqz%2Fuploads%2FdWt986VZq4tp3i1dI58d%2F06-doc-capture.jpg?alt=media\&token=aa7655f2-37bf-400f-affa-13ff373ed9f3)

### 7) Document accepted

If the quality and type of document are correct, the widget confirms successful capture. If there are issues, the user sees a hint on what to fix (e.g., “fields not visible”).\
![Document accepted](https://1453876250-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRr3zB0xucM3fgCViuJqz%2Fuploads%2FZ5GfPUy4Zytxz0T6CGoI%2F07-doc-accepted.jpg?alt=media\&token=8d0ba9d9-1945-4153-baf4-37f3d8555e20)

### 8) Selfie with document instructions

Next, the widget asks the user to take a selfie while holding the document so that **both the face and the document are fully visible**.\
![Selfie with document instructions](https://1453876250-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRr3zB0xucM3fgCViuJqz%2Fuploads%2FaquNQ8C5rZIJljLCNYeB%2F08-selfie-instruction.jpg?alt=media\&token=4c989fa2-5ee6-4b28-8b1e-7234de0ede98)

### 9) Selfie with document

The user takes a selfie, placing the document next to their face so both objects fully appear in the frame.\
![Example of selfie with document](https://1453876250-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRr3zB0xucM3fgCViuJqz%2Fuploads%2FYjYfYZrAp6Q0j2WdAVyN%2F09-selfie-with-doc.jpg?alt=media\&token=3c9d8f95-c68f-40f2-8b8a-c9b0057daa84)

### 10) Completion

After successful processing of all steps, the widget notifies the user that verification is complete.\
![Verification successfully completed](https://1453876250-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRr3zB0xucM3fgCViuJqz%2Fuploads%2FOW18t9WxmMF0U4BS7uxq%2F10-success.jpg?alt=media\&token=38094fd4-f62f-4766-8b80-eee3bffd8f26)

***

## When to use Web SDK

* Quick integration of remote identity verification (client onboarding, employees, couriers, etc.).
* Meeting KYC/AML requirements without building a complex frontend from scratch.
* Scenarios involving documents, selfies, liveness, and anti‑fraud checks.
* When consistent performance in mobile browsers and desktop is required.

***

## Capture recommendations

* Capture in good lighting, without strong glare or deep shadows.
* Hold the document fully in frame; do not cover key areas (photo, stamp, signatures, numbers).
* Keep the camera steady; retake the picture if necessary.

***
