# Верификация пользователя

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

В поле **Провайдер верификации** можно выбрать один из двух вариантов:

* **Классический** — стандартная встроенная верификация через сайт, при использовании которой клиенты на веб-части Вашего сайта проходя верификацию личности будут ожидать ручную модерацию через админ-панель, что попадают в общий список раздела "Общие" - ["Верификации"](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="https://2391054755-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKqXT4jWa7TDQpKKq2Yaf%2Fuploads%2FpQ5GIebWZUo1xafcF1uu%2Fimage.png?alt=media&#x26;token=bf3161a7-8362-469a-a473-b11eaf992282" 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="https://2391054755-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKqXT4jWa7TDQpKKq2Yaf%2Fuploads%2Foqok9pkTcrmH3m5LAHOR%2Fimage.png?alt=media&#x26;token=f4d5d80c-6b39-494e-add2-fc5d9ebc79a9" 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="https://2391054755-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKqXT4jWa7TDQpKKq2Yaf%2Fuploads%2F8qvZ2foE0XN7nnxEbDT3%2F%D0%97%D0%BD%D1%96%D0%BC%D0%BE%D0%BA%20%D0%B5%D0%BA%D1%80%D0%B0%D0%BD%D0%B0%202026-03-31%20%D0%BE%2016.48.10.png?alt=media&#x26;token=c4223653-43c2-49ee-8381-9e5bfff9ac30" alt="" width="563"><figcaption></figcaption></figure>

### Процесс верификации для пользователя

После настройки SumSub:

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

### Отображение результатов

* Заявки **не отображаются** в разделе:\
  **Общие → Верификации**
* Результат верификации доступен в:\
  **Общие → Пользователи**

Дополнительно:

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

<figure><img src="https://2391054755-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKqXT4jWa7TDQpKKq2Yaf%2Fuploads%2F3mpWzYfNH7YiZoOBH6rs%2Fimage.png?alt=media&#x26;token=4fc8927e-8393-4215-bc1e-1422a0a431a5" alt="" width="563"><figcaption></figcaption></figure>