KYC сервисы
Раздел «KYC сервисы» используется для подключения и настройки способов проверки личности клиента.
Простыми словами: здесь администратор создаёт сервис, через который клиент будет проходить KYC. Проверка может быть ручной, когда документы смотрит администратор, или автоматической, когда данные отправляются во внешний сервис.
Путь в панели управления: «Утилиты» — «KYC сервисы»
Что такое KYC сервис
KYC сервис — это конкретная настройка проверки личности на базе выбранного провайдера.
Важно не путать:
Провайдер
Тип проверки: Manual, SumSub, ID.World, Identomat
Сервис
Конкретная настройка на базе провайдера
Например, можно создать несколько сервисов на одном провайдере:
Ручной KYC
Manual
SumSub Production
SumSub
SumSub Test
SumSub
Identomat основной
Identomat
Это удобно, если нужно отдельно держать тестовую и рабочую интеграцию.
Доступные провайдеры
В системе доступны следующие провайдеры KYC:
Manual
Ручная проверка документов администратором
SumSub
Автоматическая проверка через SumSub
ID.World
Автоматическая проверка через ID.World
Identomat
Автоматическая проверка через Identomat
Что отображается на странице
На странице «KYC сервисы» отображается список всех созданных сервисов.
В таблице есть следующие колонки:
Сервис
Название созданного KYC сервиса
Провайдер
На базе какого провайдера работает сервис
Создано
Дата создания сервиса
Обновлено
Дата последнего изменения
Статус
Включён сервис или отключён
Действия
Дополнительные действия по сервису
Статус сервиса
У каждого сервиса есть переключатель статуса.
Статус
Что означает
Включён
Сервис активен и может использоваться для KYC
Выключен
Сервис хранится в системе, но не должен использоваться для новых проверок
Важно: если отключить единственный активный KYC-сервис, клиенты могут потерять возможность пройти проверку личности. Перед отключением проверьте, какой сервис выбран в основных настройках KYC.
Добавление KYC сервиса
Чтобы создать новый сервис:
Откройте «Утилиты» — «KYC сервисы».
Нажмите «Добавить сервис».
Укажите название сервиса.
Выберите провайдера.
Укажите статус: включён или выключен.
Нажмите «Добавить KYC сервис».
Поля при создании
Название сервиса
Понятное имя сервиса, например SumSub Production или Ручная проверка
Провайдер
Драйвер, на базе которого будет создан сервис
Статус
Включить сервис сразу или оставить отключённым
После создания система подготавливает место для параметров подключения.
Для Manual дополнительные ключи не нужны. Для внешних провайдеров после создания нужно открыть сервис и заполнить параметры подключения.
Редактирование сервиса
Чтобы изменить сервис, нажмите на его название в таблице.
В окне редактирования можно изменить:
Название сервиса
Отображаемое имя сервиса
Статус
Включён или выключен
Параметры подключения
Ключи, токены и другие данные провайдера
Дополнительные настройки
Если они предусмотрены выбранным провайдером
Конструктор формы
Только для Manual-сервиса
После сохранения изменения применяются сразу.
Параметры подключения
Параметры подключения зависят от выбранного провайдера.
SumSub
Для SumSub доступны следующие параметры:
Access Token
Токен доступа SumSub
Access Secret
Секретный ключ SumSub
Level Name
Название уровня проверки в SumSub
ExternalUserId Prefix
Префикс для внешнего ID пользователя
Fresh seconds
Время актуальности сессии или токена в секундах
Пример названия сервиса: SumSub Production или SumSub Test.
Identomat
Для Identomat доступны следующие параметры:
Поле
Описание
Company Key
Ключ компании
Secret Key
Секретный ключ
Allowed Document Countries
Разрешённые страны документов через запятую
Allowed Document Types
Разрешённые типы документов через запятую
Fresh seconds
Время актуальности сессии или токена в секундах
Защита секретных данных
Секретные поля хранятся защищённо.
Если секретный ключ уже был заполнен, система не показывает его открытым текстом.
Правила работы с секретными полями:
Ключ уже заполнен и менять его не нужно
Оставьте поле пустым
Нужно заменить ключ
Введите новый ключ и сохраните
Нужно проверить, заполнен ли ключ
Система покажет, что параметр уже задан
Это защищает токены и секретные ключи от случайного просмотра.
Действия сервиса
У каждого сервиса есть меню действий.
Заявки
Открывает список KYC-заявок по выбранному сервису
Логи
Открывает журнал событий выбранного сервиса
Конструктор
Доступен для Manual-сервиса и открывает настройку ручной формы
Удалить
Удаляет KYC-сервис
Заявки
Кнопка «Заявки» открывает список KYC-заявок, связанных с выбранным сервисом.
Этот раздел помогает посмотреть:
Кто проходил проверку
Пользователи, которые запускали KYC через этот сервис
Какие заявки созданы
Все попытки проверки
Какие заявки ожидают проверки
Актуальные ручные или незавершённые проверки
Какие проверки завершены
Одобренные, отклонённые или ошибочные проверки
Например, если открыть заявки у сервиса «Ручной», будут показаны KYC-заявки, которые проходили через ручную проверку.
Конструктор ручной формы
Кнопка «Конструктор» доступна только у сервиса с провайдером Manual.
Через конструктор настраивается форма, которую клиент заполняет при ручной проверке личности.
В конструкторе можно настроить:
Название формы
Заголовок формы
Описание формы
Пояснение для клиента
Список полей
Какие данные нужно запросить
Порядок полей
В каком порядке они отображаются
Обязательность
Какие поля клиент обязан заполнить
Подсказки
Помощь клиенту при заполнении
Фото
Какие изображения нужно загрузить
Типы элементов формы
Поле ввода
Обычное текстовое поле, например Ф.И.О.
Описание
Текстовый блок с пояснением
Фото
Загрузка изображения, например паспорта или селфи
Настройки одного поля
Ключ поля
Внутреннее имя поля
Тип поля
Текст, описание или фото
Название поля
Название, которое увидит клиент
Подсказка внутри поля
Пример или подсказка в поле
Описание под полем
Дополнительное пояснение
Обязательное поле
Без него клиент не сможет отправить форму
Форматы фото
Разрешённые форматы изображений
Макс. размер, МБ
Максимальный размер файла
Поля можно перетаскивать и менять их порядок.
Стандартная ручная форма
Если для Manual-сервиса ещё нет формы, система может использовать стандартный набор полей:
Ф.И.О
Фамилия, имя и отчество
Фото или скан паспорта
Изображение документа
Фото с паспортом на фоне сайта
Селфи клиента с документом
Для фото обычно используются форматы: jpg, jpeg, png.
Как работает ручная проверка
Процесс ручного KYC выглядит так:
Клиент открывает форму верификации.
Заполняет данные.
Загружает необходимые фото.
Отправляет заявку.
В админке появляется KYC-заявка на проверку.
Администратор открывает заявку.
Проверяет данные и файлы.
Подтверждает или отклоняет проверку.
Результат сохраняется в системе.
Если у клиента уже есть KYC-заявка в ожидании, система не должна создавать вторую такую же ожидающую заявку по той же цели проверки.
Удаление сервиса
Сервис можно удалить через кнопку «Удалить».
При удалении:
Удаляется KYC-сервис
Сервис исчезает из списка
Удаляются настройки подключения
Защищённые параметры сервиса очищаются
Обновляется состояние KYC
Система пересчитывает доступные сервисы
Перед удалением важно проверить, используется ли сервис в основных настройках KYC.
Если удалить активный сервис, клиенты могут потерять возможность пройти проверку.
Рекомендуемый порядок:
Создайте новый сервис.
Настройте его.
Подключите его в основных настройках KYC.
Проверьте работу на тестовом клиенте.
Только после этого удаляйте старый сервис.
Как подключить внешний KYC
Пример подключения SumSub:
Откройте «Утилиты» — «KYC сервисы».
Нажмите «Добавить сервис».
Укажите название, например SumSub Production.
Выберите провайдера SumSub.
Включите статус сервиса.
Сохраните сервис.
Откройте созданный сервис.
Заполните Access Token, Access Secret, Level Name и другие параметры.
Сохраните изменения.
Перейдите в основные настройки верификации личности.
Выберите этот сервис как активный.
Проверьте прохождение KYC на тестовом клиенте.
Как настроить ручной KYC
Откройте «Утилиты» — «KYC сервисы».
Убедитесь, что есть сервис с провайдером Manual.
Если его нет, нажмите «Добавить сервис».
Укажите название, например Ручной KYC.
Выберите провайдера Manual.
Включите статус.
Сохраните сервис.
В меню действий нажмите «Конструктор».
Настройте форму для клиента.
Добавьте нужные поля и фото.
Отметьте обязательные поля.
Сохраните форму.
Перейдите в основные настройки KYC.
Выберите ручной сервис для проверки личности.
Связь с основной верификацией личности
Раздел «KYC сервисы» только создаёт и настраивает сервисы.
Чтобы сервис реально использовался клиентами, его нужно выбрать в основных настройках верификации личности.
Логика такая:
В разделе «KYC сервисы» создаётся сервис.
В сервисе заполняются параметры подключения.
В основных настройках KYC выбирается активный сервис.
Клиент проходит проверку.
Результаты появляются в KYC-заявках и логах.
Если сервис создан, но нигде не выбран, он просто хранится в системе и не используется клиентами.
Что проверить перед изменением сервиса
Перед изменением, отключением или удалением сервиса проверьте:
Включён ли сервис
Чтобы понимать, используется ли он сейчас
Выбран ли он в настройках KYC
Чтобы не отключить активную проверку
Есть ли по нему заявки
Чтобы не потерять рабочий процесс
Есть ли ошибки в логах
Чтобы понять, корректно ли работает сервис
Заполнены ли ключи
Для внешних провайдеров без ключей проверка не заработает
Есть ли тестовая проверка
Перед запуском в работу лучше проверить на тестовом клиенте
Частые проблемы
Проблема
Что проверить
Клиент не может пройти KYC
Включён ли сервис и выбран ли он в основных настройках
Сервис создан, но не используется
Возможно он не выбран в настройках верификации личности
Внешний KYC не запускается
Проверьте токены, ключи и параметры подключения
SumSub возвращает ошибку
Проверьте Access Token, Access Secret и Level Name
Не отображается конструктор
Конструктор доступен только для Manual-сервиса
Ручная форма не отправляется
Проверьте обязательные поля и настройки загрузки фото
После отключения KYC не работает
Возможно был отключён единственный активный сервис
Старый секретный ключ не виден
Это нормально: секретные поля скрываются
Последнее обновление
Это было полезно?