> 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-sumsub.md).

# KYC Модуль SumSub

Инструкция по настройке модуля верификации SumSub

{% hint style="info" %}
Инструкция содержит аннотации с иллюстрациями описанных шагов. Нажмите на текст, подчеркнутый пунктиром, чтобы увидеть аннотацию.
{% endhint %}

1. Ознакомьтесь с общим принципом работы и настройки верификации пользователей в мануале: [KYC модули](/dopolnitelnye-sistemy/kyc-moduli.md).
2. [**Зарегистрируйте**](#user-content-fn-1)[^1] аккаунт в сервисе SumSub по [ссылке](https://cockpit.sumsub.com/checkus#/signUp) и [зайдите ](#user-content-fn-2)[^2]в личный кабинет.&#x20;
3. Зайдите в раздел "**Dev space**" -> "**WebSDK settings**". Под полем "**Domains to host Web SDK**" нажмите "**Add domain**" -> вставьте ссылку на ваш обменный сервис в формате <https://www.yourexchanger.com/> -> нажмите "[**Save**](#user-content-fn-3)[^3]".
4. В админ панели скрипта BoxExchanger, зайдите на страницу "**Доп модули**" -> в разделе "**KYC SYSTEM**" **нажмите** на [**настройки модуля**](#user-content-fn-4)[^4] SumSub -> скопируйте ваш "[**PUBLIC IP**](#user-content-fn-5)[^5]".
5. Вернитесь в ЛК SumSub -> раздел "**Dev space**" -> "**App tokens**" -> нажмите "[**Generate app token**](#user-content-fn-6)[^6]" -> в поле "**Name**" укажите удобное для вас название для Token -> для "**Allowed IPs to sign in for Dashboard**" выберите "**Allow only specified addressed**" -> в поле введите значение "**Public IP**", который вы скопировали на шаге 3 -> нажмите "[**Generate app token**](#user-content-fn-7)[^7]".
6. Скопируйте в надежное место значения [**Token и Secret Key**](#user-content-fn-8)[^8] из личного кабинета (ЛК) SumSub -> нажмите "**Confirm saving and leave**" -> перейдите в админ панель скрипта BoxExchanger на страницу настроек модуля SumSub -> вставьте скопированное значение "**Token**" в поле "**Access token**" и нажмите "**Save**" -> значение "**Secret Key**" вставьте в поле "**Access secret**" и нажмите "[**Save**](#user-content-fn-9)[^9]".
7. Со страницы настроек SumSub в админ панели BoxExchanger, скопируйте значение "[**WEBHOOK URL (APPLICANT REVIEWED)**](#user-content-fn-10)[^10]".
8. Вернитесь в ЛК SumSub - подраздел "**Webhooks**" - "**Webhook manager**" -> нажмите "[**Create webhook**](#user-content-fn-11)[^11]" -> на открывшейся странице настроек ([**скриншот настройки**](#user-content-fn-12)[^12]), в поле "**Name**" укажите удобное для вас имя для Webhook'a -> для "**Webhook receiver**" оставьте значение "**HTTP address**" -> в поле "**Target**" вставьте скопированную ссылку из шага 6 -> для "**Webhook types**" выберите "**applicantReviewed**" -> для "**Applicant types**" выберите "**Individual**" -> скопируйте значение из поля "**Secret key**" -> вставьте "**Secret key**" в админ панели скрипта на странице настроек модуля в поле "[**webhookSecret**](#user-content-fn-13)[^13]" и нажмите "**Save**" -> вернитесь на страницу настроек webhook'a SumSub -> для "**Signature algorithm**" выберите "**SHA256**" (мы также поддерживаем и SHA512) -> для "**Try to resend failed webhooks several times**" оставьте checkbox активным -> нажмите "[**Create webhook**](#user-content-fn-14)[^14]".
9. Перейдите в раздел "**Integrations**" - подраздел "**Individials**" - настройте собственный "**Level**" ([документация тут](https://help.sumsub.com/dashboard-v.2/applicant-levels)) / выберите уже из существующих -> [**скопируйте**](#user-content-fn-15)[^15] имя "**Level**" -> перейдите в админ панель скрипта на страницу настроек модуля SumSub -> вставьте название "**Level**" в поле "**Level name**" и нажмите "[**Save**](#user-content-fn-16)[^16]".&#x20;

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

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

{% hint style="success" %}
В админ панеле скрипта - на странице "**Пользователи**" [**отмечаются** ](#user-content-fn-19)[^19]верифицированные аккаунты. \
Также, в случае успешной верификации, в админ панеле на странице пользователя, ползунок напротив "[**Верифицирован**](#user-content-fn-20)[^20]" будет в активном положении.&#x20;
{% endhint %}

[^1]: ![](https://3272217808-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKMtUdLxlDooDfKq13Is6%2Fuploads%2FzM4nYZAWG0Ts7vAQbXXj%2Fimage.png?alt=media\&token=acece2c1-0965-4142-9a96-8c5530b92d7e)

[^2]: ![](https://3272217808-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKMtUdLxlDooDfKq13Is6%2Fuploads%2F81dR6c8Sh2RLafNPfutm%2Fimage.png?alt=media\&token=a14bc2e5-2443-40d1-b598-bb585a53c121)

[^3]: ![](https://3272217808-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKMtUdLxlDooDfKq13Is6%2Fuploads%2FNHmPf34mFNQiyhKKWSss%2Fimage.png?alt=media\&token=855534e4-60fa-43d7-9e4c-73814e0ab354)

[^4]: ![](https://3272217808-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKMtUdLxlDooDfKq13Is6%2Fuploads%2FhD7KdaCCLhA0gkia41Jb%2Fimage.png?alt=media\&token=7affb63e-d8b5-4b30-ac19-b1979cf115f0)

[^5]: ![](https://3272217808-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKMtUdLxlDooDfKq13Is6%2Fuploads%2FQCP0fRmqxaJCir52aJmz%2Fimage.png?alt=media\&token=8395df30-4941-44f3-b372-f5baccc8c935)

[^6]: ![](https://3272217808-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKMtUdLxlDooDfKq13Is6%2Fuploads%2FQaJQEmeHCtJXP4zCAAcm%2Fimage.png?alt=media\&token=92ef1fe9-0722-4a30-ae4b-2dbddda1b449)

[^7]: ![](https://3272217808-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKMtUdLxlDooDfKq13Is6%2Fuploads%2FTivIJZa0Xvk11DpF9U7r%2Fimage.png?alt=media\&token=863fafc1-f5d0-40d1-83bd-19e905bd08ad)

[^8]: ![](https://3272217808-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKMtUdLxlDooDfKq13Is6%2Fuploads%2FJMxtJEonMqp8becJnfy0%2Fimage.png?alt=media\&token=1dbcefbb-98be-4f2f-a81d-9a0ae51b7e97)

[^9]: ![](https://3272217808-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKMtUdLxlDooDfKq13Is6%2Fuploads%2Fn69fjcC1UIGZQ6UoPJKp%2Fimage.png?alt=media\&token=3b075a0b-5c68-4b0c-8e20-e2001c90d3e6)

[^10]: ![](https://3272217808-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKMtUdLxlDooDfKq13Is6%2Fuploads%2FwnEz0TIhJk4BnVwum0Sb%2Fimage.png?alt=media\&token=37e115ca-c239-4842-b311-35c0e6ea3442)

[^11]: ![](https://3272217808-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKMtUdLxlDooDfKq13Is6%2Fuploads%2FluvxybLhfgxpq6t6oZaT%2Fimage.png?alt=media\&token=2d0e1090-2aa4-41f7-9165-59f50fca2c16)

[^12]: ![](https://3272217808-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKMtUdLxlDooDfKq13Is6%2Fuploads%2FFoG8xSdkCOaGu0wVDmBd%2Fimage.png?alt=media\&token=c21427c6-cd3f-4a2f-8205-d976cbc1a230)

[^13]: ![](https://3272217808-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKMtUdLxlDooDfKq13Is6%2Fuploads%2FNErvy8BXz7t38kitazhe%2Fimage.png?alt=media\&token=7f78f48f-02a3-4106-a087-fe7c84832c8a)

[^14]: ![](https://3272217808-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKMtUdLxlDooDfKq13Is6%2Fuploads%2F4Y7X3VamzucYkUfgdKf2%2Fimage.png?alt=media\&token=d58b4591-6cd7-48bb-8fcb-37b51a1fa2a1)

[^15]: ![](https://3272217808-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKMtUdLxlDooDfKq13Is6%2Fuploads%2FMKG5vbSuFZa4Vj7pzo0r%2Fimage.png?alt=media\&token=b05aecf9-3901-4f51-baac-82d119a73527)

[^16]: ![](https://3272217808-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKMtUdLxlDooDfKq13Is6%2Fuploads%2FfGefDmaOcOkTZpDHL4jr%2Fimage.png?alt=media\&token=776f9945-0209-47eb-afe6-11a1ad58ba53)

[^17]: ![](https://3272217808-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKMtUdLxlDooDfKq13Is6%2Fuploads%2FSUIYypr2p4w94sSonWRK%2Fimage.png?alt=media\&token=a58d2ba3-fb22-42f9-bd6b-e2f4c8e112d9)

[^18]: ![](https://3272217808-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKMtUdLxlDooDfKq13Is6%2Fuploads%2FC7EL4Gv3RgqU3FyAXfC1%2Fimage_2023-07-19_12-46-00.png?alt=media\&token=124a646a-ca4d-4c1a-953e-861eee97155c)

[^19]: ![](https://3272217808-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKMtUdLxlDooDfKq13Is6%2Fuploads%2FlZYXXhpX0sqdbAs3J8eM%2Fimage.png?alt=media\&token=1b525ef5-c904-455c-9f11-76cbbb1c90aa)

[^20]: ![](https://3272217808-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKMtUdLxlDooDfKq13Is6%2Fuploads%2Fs8wtmO2Bpqu1kic0XEqP%2Fimage.png?alt=media\&token=c1538d68-38ce-4a1a-a6e3-02b81eca331c)
