> For the complete documentation index, see [llms.txt](https://lara-script.gitbook.io/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://lara-script.gitbook.io/docs/ua/funkcional-admin-paneli/nalashtuvannya/verifikaciya-koristuvacha.md).

# Верифікація користувача

У розділі доступна настройка способу проходження верифікації особи на сайті.

У полі **Провайдер верифікації** можна вибрати один із двох варіантів:

* **Класичний** — стандартна вбудована верифікація через сайт, під час використання якої клієнти на веб-частині Вашого сайту, проходячи верифікацію особи, очікуватимуть ручну модерацію через адмін-панель, що потрапляють до загального списку розділу "Загальні" - ["Верифікації"](https://lara-script.gitbook.io/docs/ru/funkcional-admin-paneli/obshie/verifikaciya).
* **SumSub** **(Sum & Substance)** — це сторонній KYC-провайдер, який автоматизує перевірку користувачів (документи, селфі, відео-верифікація) і автоматично ухвалює рішення (approve / reject) практично миттєво. 

Залежно від обраного варіанта змінюється процес проходження верифікації.

### Класичний режим

При виборі **Класичного** режиму:

* процес верифікації не змінюється
* заявки користувачів відображаються в розділі:\
  **Загальні → Верифікації**

### Режим SumSub

При виборі **SumSub** з'являються додаткові поля для налаштування:

* **Ключ API**
* **Секретний API ключ**
* **Рівень KYC**
* **Webhook Secret**
* **URL вебхука**

<figure><img src="/files/aXJ565PWHSQI6R6aAw7E" alt=""><figcaption></figcaption></figure>

Щоб коректно налаштувати функціонал SumSub, дотримуйтеся кроків, описаних нижче:

### Отримання даних із SumSub

#### 1. Реєстрація

[Зареєструйтеся](https://cockpit.sumsub.com/checkus/signUp) в сервісі SumSub.

#### 2. Отримання API ключів

[Перейдіть у розділ](https://cockpit.sumsub.com/checkus/devSpace/appTokens):

Далі виконайте такі дії:

* натисніть **Generate app token**
* у результаті буде згенеровано:
  * **Token**
  * **Secret Key**

<figure><img src="/files/40874d81c39920ef272c1d6bec0d525e250f2175" alt=""><figcaption></figcaption></figure>

Отримані значення необхідно вказати в адмін-панелі:

* **Ключ API** → Token
* **Секретний API ключ** → Secret Key

#### 3. Налаштування рівня верифікації (KYC Level)

Перейдіть у [розділ рівнів верифікації:](https://cockpit.sumsub.com/checkus/sdkIntegrations/levels/individual)

Далі:

* створіть новий рівень або виберіть наявний (наприклад: `id-only`)
* налаштуйте необхідні параметри перевірки (документи, селфі, відео тощо)
* у системі SumSub рівень відповідає KYC configuration

Докладніше про розділ у документації:\
<https://docs.sumsub.com/docs/verification-levels>

Отримане значення рівня необхідно вказати в адмінці в полі:\
**Рівень KYC**

#### 4. Налаштування Webhook

Перейдіть у [менеджер вебхуків](https://cockpit.sumsub.com/checkus/devSpace/webhooks/webhookManager):

Далі створіть webhook з такими параметрами:

* **Name** — будь-яка назва (не впливає на роботу системи)
* **Webhook receiver** — HTTP address
* **Target** —\
  `https://<домен>/api/v1/user-verification/sumsub/webhook`\
  (URL можна взяти з поля **URL вебхука** в адмінці)
* **Webhook types** — можна вибрати всі або необхідні події
* **Applicant types** — `Individual`
* **Secret key** — необхідно скопіювати і потім вказати в адмінку (розділ **Webhook Secret**)
* **Signature algorithm** — `SHA256`
* **Resend failed webhooks several times** — увімкнено

Документація з вебхуків:\
<https://docs.sumsub.com/docs/webhooks>

Після збереження:

* поверніться в адмін-панель
* заповніть усі поля адмін-панелі отриманими даними
* натисніть "Зберегти"
* перейдіть знову на сторінку SumSub і натисніть **Test webhook**

Очікуваний результат:

<figure><img src="/files/dbe915b6937a467a81e17e786fad83d40173b74d" alt="" width="563"><figcaption></figcaption></figure>

### Процес верифікації для користувача

Після налаштування SumSub:

1. Користувач проходить верифікацію в особистому кабінеті
2. Відбувається редирект у SumSub
3. Користувач:
   * обирає країну
   * обирає тип документа
   * завантажує документи
   * (опціонально) проходить відео-верифікацію
4. Система автоматично ухвалює рішення (approve / reject) і автоматично підтягує статус його верифікації в Особистий кабінет

### Відображення результатів

* Заявки **не відображаються** в розділі:\
  **Загальні → Верифікації**
* Результат верифікації доступний у:\
  **Загальні → Користувачі**

Додатково:

* з'явилося поле **Провайдер верифікації**
* для таких користувачів буде вказано: **SumSub**

<figure><img src="/files/SsdKkhJ3vXKGVSs5mZIk" alt=""><figcaption></figcaption></figure>

### Режим Sandbox (тестове середовище)

Після реєстрації в SumSub за замовчуванням використовується **Sandbox-режим (пісочниця)**.

Це тестове середовище, призначене для налаштування інтеграції та перевірки роботи сервісу, а не для реальної верифікації користувачів.

### Особливості Sandbox режиму

* Перевірки в цьому режимі є **тестовими і не вважаються реальними**
* Результати верифікації можуть бути згенеровані системою і не відображають реальну перевірку документів
* Використовується для:
  * налаштування API та webhook
  * тестування користувацького флоу
  * перевірки інтеграції

👉 У Sandbox режимі відсутні повноцінні алгоритми перевірки — він призначений лише для тестування ([Sumsub](https://docs.sumsub.com/docs/test-in-sandbox?utm_source=chatgpt.com))

### Перехід у Production

Для того щоб верифікація працювала по-справжньому:

* необхідно переключитися в **Production режим** у кабінеті SumSub
* лише в цьому режимі виконуються реальні перевірки користувачів
* верифікації починають враховуватися й оброблятися системою повноцінно