For the complete documentation index, see llms.txt. This page is also available as Markdown.

Верификация личности (KYC)

Верификация личности, или KYC, используется для подтверждения личности клиента перед созданием заявки или во время обработки обмена.

KYC помогает повысить безопасность обменного сервиса, снизить риски мошенничества и выполнять внутренние правила проверки клиентов.

Путь в панели управления: «Верификация» — «Верификация личности»


Для чего нужна верификация личности

KYC может влиять на разные части системы:

Область
Как влияет KYC

Создание заявки

Может запретить создание заявки до прохождения проверки

Страница оплаты

Может показать клиенту форму проверки прямо внутри заявки

Карточка клиента

Отображает, подтверждена ли личность клиента

Заявки

Может помечать заявку как требующую проверки

Бонусы и уровни

Может быть условием для получения уровня или преимущества

Журналы

Сохраняет историю проверок, ошибок и действий провайдера

Статусы ручной проверки

Статус
Что означает

На проверке

Клиент отправил данные, администратор ещё не принял решение

Подтверждено

Личность клиента подтверждена

Отклонено

Проверка не пройдена

Действия администратора

Действие
Описание

Просмотр

Открывает детали KYC-заявки, поля и загруженные файлы

Подтвердить

Одобряет проверку личности клиента

Отклонить

Отклоняет проверку с обязательным указанием причины

Удалить

Удаляет завершённую или отклонённую KYC-заявку из списка

Если администратор нажимает «Подтвердить», у клиента включается признак подтверждённой личности. После этого система считает, что клиент прошёл KYC.

Если администратор нажимает «Отклонить», клиент остаётся непроверенным, а причина отказа сохраняется в истории проверки.


Настройки KYC

В основном разделе есть кнопка настроек с иконкой шестерёнки.

В настройках задаются глобальные параметры KYC.

Настройка
Описание

Верификация личности

Глобально включает или выключает KYC

Верификация внутри заявки

Разрешает проходить KYC прямо на странице оплаты заявки

Purpose

Назначение проверки. Для личности используется значение identity

Активный драйвер

Определяется автоматически по выбранному KYC-сервису

Выбранный KYC-сервис

Сервис, через который будет проходить проверка

Важно: если KYC включён, но активный KYC-сервис не выбран, система не сможет корректно запускать проверку.

KYC-сервисы

KYC-сервисы подключаются в отдельном разделе: «Инструменты» — «KYC сервисы»

Здесь настраивается способ проверки личности.


Ручная KYC-форма

Если выбран сервис Manual, клиент проходит ручную проверку.

По умолчанию форма может включать:

Поле
Назначение

Ф.И.О

Указание полного имени клиента

Фото или скан паспорта

Подтверждение документа

Фото клиента с паспортом на фоне сайта

Дополнительная проверка личности

Конструктор ручной формы

В конструкторе можно настроить:

Параметр
Описание

Название формы

Заголовок формы для клиента

Описание формы

Пояснение перед заполнением

Порядок полей

Очередность отображения

Ключ поля

Системное имя поля

Тип поля

Обычное поле, описание или фото

Название поля

Название, которое видит клиент

Подсказка

Текст внутри поля

Описание под полем

Дополнительное пояснение

Обязательность

Обязательное поле или нет

Форматы фото

Разрешённые форматы файлов

Максимальный размер файла

Ограничение размера загружаемого файла

При сохранении формы создаётся новая версия. Старые KYC-заявки не ломаются, потому что в каждой заявке сохраняется снимок формы, по которой клиент отправлял данные.

Если у клиента уже есть ручная KYC-заявка в статусе «На проверке», повторно отправить новую он не сможет, пока текущая заявка не будет обработана.


Настройки KYC на валюте

Базовые правила KYC задаются на уровне валюты.

Путь: «Основное» — «Валюты» — «Список валют» — нужная валюта — «Верификация» — «Верификация личности»

Эти правила применяются к направлениям, где выбранная валюта используется как валюта «Отдаю».

Режимы проверки на валюте

Режим
Как работает

Выключена

KYC по этой валюте не требуется

Всегда требуется

Каждый обмен с этой валютой требует проверки личности

Только с указанной суммы

KYC включается, если сумма «Отдаю» достигла указанного порога

Только для новых клиентов

KYC нужен клиентам без успешных завершённых обменов

Только для клиентов без идентификации

KYC нужен только клиентам, которые ещё не прошли проверку

Дополнительные параметры валюты

Параметр
Описание

Минимальная сумма обмена

Порог суммы, после которого требуется KYC

Краткое описание

Короткое пояснение для клиента

Подробная инструкция

Детальное описание прохождения проверки

Поведение для непроверенного клиента

Определяет, когда клиент должен пройти KYC

Поведение для непроверенного клиента

Поведение
Как работает

Сначала верификация → затем заявка

Клиент не сможет создать заявку, пока не пройдёт KYC

Создать заявку → затем запросить верификацию

Клиент создаёт заявку, после чего система запросит KYC


Настройки KYC на направлении

Для отдельного направления можно использовать свои правила KYC.

Путь: «Основное» — «Направление обмена» — «Список направлений» — нужное направление — «Верификация» — «Верификация личности»

Режимы на направлении

Режим
Описание

По умолчанию: из настроек валюты

Направление использует правила валюты «Отдаю»

Отдельные правила для направления

Для направления задаются собственные правила KYC

Если выбраны отдельные правила, можно указать:

Параметр
Описание

Режим проверки

Когда требуется KYC

Минимальная сумма

Порог суммы для проверки

Краткое описание

Короткое пояснение

Подробная инструкция

Полный текст инструкции

Практически важный момент: поведение «сначала KYC» или «заявка → затем KYC» надёжнее задавать на уровне валюты. Направление в основном управляет режимом, суммой и текстами.


Как KYC влияет на создание заявки

Система проверяет необходимость KYC в момент создания заявки.

Алгоритм работы:

  1. Проверяется, включён ли глобальный KYC.

  2. Проверяется, выбран ли активный KYC-сервис для identity.

  3. Берутся правила валюты «Отдаю».

  4. Если у направления включены отдельные правила, они заменяют правила валюты.

  5. Система проверяет режим KYC.

  6. Если клиент уже прошёл KYC, заявка создаётся без блокировки.

  7. Если клиент не прошёл KYC, система действует по выбранному поведению.

Что происходит при разных режимах

Поведение
Результат

Сначала верификация → затем заявка

Система не даст создать заявку и попросит пройти KYC

Создать заявку → затем запросить верификацию

Заявка создаётся, но помечается как требующая проверки личности

Клиент уже прошёл KYC

Заявка создаётся без дополнительных ограничений

KYC выключен

Проверка личности не запрашивается


Как это видит клиент

Клиент может увидеть запрос KYC:

Место
Что происходит

Личный кабинет

Клиент может пройти проверку личности

Страница оплаты заявки

KYC может отображаться прямо внутри заявки

Создание заявки

Система может потребовать пройти проверку до создания

После создания заявки

Заявка может быть создана, но потребует проверки перед продолжением

Если включена настройка «Верификация внутри заявки», клиент может пройти KYC прямо на странице оплаты.

Если KYC уже пройден, система считает клиента проверенным и не требует повторной ручной проверки для правил, где достаточно подтверждённой личности.


Что происходит после успешной проверки

После успешного KYC:

Результат
Описание

Клиент становится подтверждённым

В карточке пользователя включается признак подтверждённой личности

Заявка больше не блокируется по KYC

Если заявка требовала проверку, ограничение снимается

Клиент может создавать обмены

Для направлений, где требуется KYC

Обновляются KYC-метрики

Бонусный центр и уровни получают актуальные данные

Могут открыться уровни и бонусы

Если они завязаны на подтверждение личности


Связь с пользователем

В карточке пользователя есть признак: Личность подтверждена

Он может измениться:

Сценарий
Что происходит

Ручное подтверждение KYC

Администратор одобряет KYC-заявку

Успешный ответ KYC-провайдера

Внешний сервис подтверждает личность

Ручное изменение в карточке пользователя

Администратор меняет статус вручную

Если статус меняется, система обновляет связанные KYC-метрики клиента.


Связь с уровнями клиента и бонусами

KYC может быть условием для получения уровня или бонуса.

Например:

Условие
Результат

Уровень требует KYC, клиент не проверен

Уровень может быть недоступен

Бонус требует KYC, клиент не проверен

Бонус может не примениться

Клиент прошёл KYC

Уровни и преимущества могут стать доступными

То есть KYC влияет не только на обмен, но и на клиентские преимущества.


KYC-логи

Раздел журнала: «Журнал событий» — «KYC логи»

KYC-логи — это история технических событий KYC.

Одна строка в логах — одно событие.


Примеры настройки

1

KYC перед созданием заявки

Настройка
Значение

Глобальный KYC

Включён

KYC-сервис

Manual или внешний провайдер

Валюта «Отдаю»

KYC включён

Поведение

Сначала верификация → затем заявка

Результат: клиент не сможет создать заявку, пока не пройдёт проверку личности.

2

KYC после создания заявки

Настройка
Значение

Глобальный KYC

Включён

Верификация внутри заявки

Включена

Поведение

Создать заявку → затем запросить верификацию

Результат: заявка будет создана, но клиенту потребуется пройти KYC на странице оплаты.

3

KYC только от определённой суммы

Настройка
Значение

Режим

Только с указанной суммы

Минимальная сумма

Например, 1000

Валюта

Валюта «Отдаю»

Результат: если клиент отдаёт сумму меньше порога, KYC не требуется. Если сумма равна или выше порога — система запросит проверку личности.

4

KYC только для новых клиентов

Настройка
Значение

Режим

Только для новых клиентов


Рекомендации

Ситуация

Рекомендация

Нужно проверять всех клиентов по валюте

Используйте режим «Всегда требуется»

Нужно проверять только крупные суммы

Используйте режим «Только с указанной суммы»

Нужно не блокировать создание заявки

Используйте «Создать заявку → затем запросить верификацию»

Нужно не допускать непроверенных клиентов к обмену

Используйте «Сначала верификация → затем заявка»

Нужен простой старт

Используйте Manual-проверку

Нужна автоматизация

Подключите внешний KYC-сервис

Нужно понять проблему проверки

Откройте KYC-заявки и KYC-логи


Частые проблемы

Проблема

Что проверить

KYC не запускается

Включён ли глобальный KYC и выбран ли KYC-сервис

Клиент не видит KYC в заявке

Включена ли «Верификация внутри заявки»

Клиент не может создать заявку

Возможно выбран режим «Сначала верификация → затем заявка»

Проверка не отправляется повторно

Возможно у клиента уже есть заявка «На проверке»

Внешний провайдер не отвечает

Проверьте ключи, настройки сервиса и KYC-логи

KYC не требуется для направления

Проверьте правила валюты «Отдаю» и отдельные правила направления

Бонус не применился

Возможно уровень или бонус требует подтверждённой личности

Последнее обновление

Это было полезно?