> For the complete documentation index, see [llms.txt](https://manual.boxexchanger.net/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://manual.boxexchanger.net/dopolnitelnye-sistemy/kyc-moduli/kyc-modul-didit.md).

# KYC Модуль Didit

Инструкция по настройке KYC модуля Didit

{% stepper %}
{% step %}

#### Описание

Модуль позволяет использовать **Didit** для проведения KYC-проверки пользователей и KYB-проверки компаний.

{% hint style="info" %}
Ознакомьтесь с общим принципом работы и настройки верификации пользователей в мануале [KYC модули](/dopolnitelnye-sistemy/kyc-moduli.md).
{% endhint %}
{% endstep %}

{% step %}

#### Установка модуля

Используя параметры ниже, установите модуль через функционал "**Install plugin**" по инструкции Install plugin.

<details open>

<summary>Параметры для Install Plugin</summary>

**Plugin type**: <mark style="color:orange;">**`KYC module`**</mark>

**Plugin URL**: <mark style="color:orange;">**`@boxexchanger-plugins/kyc-didit`**</mark>

**Directory path**: <mark style="color:orange;">**`didit`**</mark>

**Auth: (Deploy token)**: оставляем пустым

**Package tag**: <mark style="color:orange;">**`latest`**</mark>

</details>
{% endstep %}

{% step %}

#### Подготовка данных в Didit

1. [**Зарегистрируйте**](https://business.didit.me/sign-up) аккаунт в сервисе Didit и [**войдите**](https://business.didit.me/sign-in) в личный кабинет.
2. После регистрации создайте **Organization**.
3. По умолчанию используется **Live**-режим. Если вы хотите сначала протестировать Didit в **Sandbox**, включите режим **Test Mode** в настройках организации.

   <figure><img src="https://3272217808-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKMtUdLxlDooDfKq13Is6%2Fuploads%2Fnd7bNIgRi9WkvXJ1bilV%2Ffile-7a13e15d9c3b223ffea8f88524de4be9.png?alt=media&#x26;token=e7777143-7663-4ea9-856b-f79bff79bef2" alt=""><figcaption></figcaption></figure>

   После успешного тестирования повторите настройку для **Live**-режима.

**Создание KYC Workflow**

4. В боковом меню откройте **Workflows** и нажмите **New Workflow**.

   На шаге **What are you verifying?** выберите **User Verification (KYC)**.

   На шаге **How do you want to build it?** выберите **Simple workflow**.

   На шаге **Template** выберите подходящий шаблон или создайте Workflow с нуля.

   Настройте необходимые проверки, например:

   * Liveness
   * Face Match
   * AML
   * NFC
   * Phone
   * Email

   После настройки сохраните Workflow.

   Скопируйте его **Workflow ID** — он понадобится при настройке модуля в BoxExchanger.

   <figure><img src="https://3272217808-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKMtUdLxlDooDfKq13Is6%2Fuploads%2FHCCfcVs3eG796fT7Gi3N%2Fimage.png?alt=media&#x26;token=ae9a98ef-53e5-4223-b44a-cfe03e893cfd" alt=""><figcaption></figcaption></figure>

**Создание KYB Workflow (опционально)**

5. Если необходимо проводить проверки компаний, создайте отдельный Workflow для KYB.

   Создайте новый Workflow и настройте необходимые проверки для компаний.

   После сохранения скопируйте его **Workflow ID**.

   > **Примечание:** поле **Workflow ID (Company/KYB)** в модуле является необязательным. Заполняйте его только при использовании KYB-проверок.

**Получение API Key**

6. В Didit откройте раздел **API keys**.

   Скопируйте **API Key** и сохраните его в надёжном месте — он понадобится при дальнейшей настройке модуля.

   <figure><img src="https://3272217808-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKMtUdLxlDooDfKq13Is6%2Fuploads%2F6M1BxirLQPsRsw26ckzo%2Fimage.png?alt=media&#x26;token=eec57c5d-3330-4787-9f55-7d702d304f53" alt=""><figcaption></figcaption></figure>

**Настройка Webhook**

7. В админ-панели скрипта BoxExchanger откройте страницу **Доп. модули** → в разделе **KYC SYSTEM** откройте настройки модуля Didit и скопируйте **Webhook URL**.<br>

   <figure><img src="https://3272217808-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKMtUdLxlDooDfKq13Is6%2Fuploads%2Ffi0BPp4jwqAg3wlGBSm5%2Ffile-1e38da2925d9141fe80c6b3b0570b3e5.png?alt=media&#x26;token=d5ec96c2-f0f1-4a60-b79c-000de8f6cf68" alt=""><figcaption></figcaption></figure>

   Вернитесь в Didit и откройте страницу **Webhooks**.

   Нажмите **Add destination** и в открывшемся окне укажите:

   a) **Name** — название webhook.\
   b) **Webhook version** — версию `3.0`.\
   c) **Webhook URL** — скопированный из админ-панели BoxExchanger **Webhook URL**.\
   d) **Subscribed events** — `status.updated`.

   Нажмите **Add destination**, чтобы создать webhook.

   <figure><img src="https://3272217808-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKMtUdLxlDooDfKq13Is6%2Fuploads%2FNeQOp3W7HcCZRrwIkgG6%2Ffile-c3c9302e6185000052eb3fac6090cb6d.png?alt=media&#x26;token=6b136324-57c7-476e-a0fa-3a94720c6b6e" alt=""><figcaption></figcaption></figure>

   В строке созданного webhook нажмите на иконку копирования, чтобы скопировать **секретный ключ webhook**. Сохраните его в надёжном месте — он также понадобится при настройке модуля.

   <figure><img src="https://3272217808-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKMtUdLxlDooDfKq13Is6%2Fuploads%2FoyduU9ZRXsGZCLu1jiVI%2Ffile-b431afac3ecd35bc519c7331d9a297b0.png?alt=media&#x26;token=76e90453-cbcf-4792-b407-d020e3b99275" alt=""><figcaption></figcaption></figure>

{% endstep %}

{% step %}

#### Настройка модуля в BoxExchanger

1. В админ-панели скрипта BoxExchanger откройте страницу **Доп. модули** → в разделе **KYC SYSTEM** откройте настройки модуля Didit.
2. В поле **Workflow ID** укажите скопированный в Didit **Workflow ID** для KYC и нажмите **Save**.
3. В поле **Workflow ID (Company/KYB)** укажите скопированный в Didit **Workflow ID** для KYB и нажмите **Save**. Данное поле является опциональным.
4. В поле **API Key** укажите скопированный в Didit **API Key** и нажмите **Save**.
5. В поле **Webhook Secret Key** укажите скопированный в Didit **секретный ключ webhook** и нажмите **Save**.

{% hint style="info" %}
Для выбора необходимого KYC-модуля перейдите в **Настройки сайта** → блок **USER SETTINGS**, выберите необходимый модуль из выпадающего списка и нажмите [**Save**](#user-content-fn-1)[^1].
{% endhint %}

6. Для проверки работы модуля войдите в личный кабинет пользователя на вашем сайте, откройте раздел **Профиль** и нажмите [**Start verification process**](#user-content-fn-1)[^1].

{% hint style="success" %}
В админ-панели скрипта на странице **Пользователи** [**отмечаются**](#user-content-fn-1)[^1] верифицированные аккаунты.

Также в админ-панели на странице пользователя переключатель [**Верифицирован**](#user-content-fn-1)[^1] будет находиться в активном положении после успешного прохождения верификации.
{% endhint %}
{% endstep %}
{% endstepper %}

[^1]: