KYB API: верификация бизнеса, реестр и UBO в Didit

Верификация бизнеса (KYB) в Didit позволяет проверять компании и юридические лица до их онбординга на платформе. Система автоматически запрашивает данные в реестрах компаний, определяет бенефициарных владельцев и должностных лиц, проверяет всех участников по спискам наблюдения AML и собирает подтверждающие документы, и всё это в рамках одного сценария. Каждая проверенная компания отслеживается как бизнес-профиль, в котором объединяются результаты всех сессий. Этот урок Didit Academy показывает весь путь проверки бизнеса: панель KYB, проверку по реестру, акционеров и UBO, AML-скрининг, а также то, что видит представитель компании со своей стороны. Впервые работаете с Didit KYB? Начните с быстрого старта, который за 10 минут проведет вас через весь процесс, а затем изучите руководство по интеграции с типовыми схемами для продакшн-среды. Модель сущности Business, включая связи с пользователями, списками блокировки и импортом и экспортом, описана в разделе Businesses.

Как это работает

Создание бизнес-сессии

Запустите верификацию бизнеса, создав сессию со сценарием KYB. Когда тип сценария — KYB, Didit автоматически создает бизнес-сессию:

curl -X POST https://verification.didit.me/v3/session/ \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "workflow_id": "your-kyb-workflow-id",
    "vendor_data": "company-123"
  }'

Тип сессии определяется сценарием, никакие дополнительные поля не нужны. Сценарии KYB автоматически создают бизнес-сессии с включенными функциями для бизнеса.

Проверка по реестру компаний

Didit запрашивает официальные реестры компаний на уровнях Lite, Shareholders или UBOs, каждый из которых оплачивается отдельно для каждой страны, см. цены на проверку по реестрам. Уровень Lite возвращает:

Данные	Описание
Название компании	Юридическое название по регистрации
Регистрационный номер	Официальный регистрационный номер компании
Страна	Страна регистрации компании
Статус	Действующая, ликвидированная, исключенная из реестра и т. д.
Тип компании	Ltd, LLC, PLC, SA, GmbH и т. д.
Дата регистрации	Дата регистрации компании
Юридический адрес	Официальный адрес регистрации
Налоговый номер	Налоговый идентификационный номер (если доступен)

Данные из реестра сопоставляются с предоставленной информацией, чтобы выявить несоответствия.

Ключевые лица: UBO, акционеры, директора и представители

Система определяет всех физических и юридических лиц, связанных с компанией, в рамках единой модели Ключевые лица:

UBO: физические лица, которые в конечном счете владеют компанией или контролируют ее, с процентом владения и процентом голосов
Акционеры (физические и юридические лица): каждый с процентом владения
Директора, представители, секретари, уполномоченные подписанты и другие должностные лица: с указанием конкретной роли
Слои корпоративной собственности: материнские компании в цепочке владения, с возможностью вложенной KYB-проверки

Один человек может иметь несколько ролей (например, директор и акционер). Каждая роль настраивается в сценарии отдельно: какие роли требуют KYC, какой KYC-сценарий использовать и может ли конечный пользователь пропустить верификацию. Подробнее в разделах Ключевые лица и Структура владения.

AML-скрининг

Все выявленные стороны автоматически проверяются по глобальным спискам наблюдения AML:

AML компании: проверяет саму компанию по санкционным спискам, негативным публикациям в СМИ и спискам регуляторных взысканий
AML-скрининг физического лица: проверяет каждое ключевое лицо (UBO, акционера, директора, представителя и т. д.) по отдельности
Использует ту же систему оценки по двум показателям (оценка совпадения и оценка риска), что и верификация пользователей

Сбор документов

Собирайте и проверяйте подтверждающие документы:

Тип документа	Примеры
Свидетельство о регистрации	Документ о регистрации компании
Устав компании	Устав, учредительный договор
Подтверждение адреса	Коммунальные счета и банковские выписки за юридический адрес
Реестр акционеров	Официальный реестр акционеров
Финансовая отчетность	Годовая отчетность, аудиторские заключения
Налоговые справки	Справки о налоговой регистрации или соблюдении налоговых требований
Дополнительные документы	Любые дополнительные документы, требуемые вашим процессом комплаенса

Аналитики могут запросить у компании дополнительные документы в ходе проверки.

Проверка и решение

Бизнес-сессия получает общий статус на основе всех проверок:

Статус	Значение
Одобрена	Все проверки пройдены, компания верифицирована
На проверке	Одна или несколько проверок требуют ручной проверки
Отклонена	Критическая проверка не пройдена (например, ликвидированная компания или санкционированная организация)

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

Жизненный цикл бизнес-сессии

Каждая верификация бизнеса выполняется в рамках бизнес-сессии, которая отслеживает прогресс с помощью следующих статусов:

Статус	Описание
`"Not Started"`	Сессия создана, но верификация еще не начата
`"In Progress"`	Верификация выполняется: идут запросы к реестрам, AML-скрининг или сбор документов
`"Approved"`	Все проверки пройдены, компания верифицирована
`"Declined"`	Критическая проверка не пройдена (например, компания ликвидирована или сущность попала под санкции)
`"In Review"`	Одна или несколько проверок требуют ручной проверки аналитиком
`"Resubmitted"`	Ранее отклоненная сессия повторно отправлена с обновленными данными

Каждая сессия имеет уникальный session_id, последовательный session_number и session_token для ссылки на размещённую страницу верификации. Если сессия создается с идентификатором vendor_data, Didit автоматически связывает ее с соответствующим бизнес-профилем.

Статусы функций

Верификация бизнеса отслеживает статус каждого компонента независимо:

Функция	Описание
Проверка реестра	Запрос к реестру компаний и извлечение данных
AML компании	AML-скрининг на уровне компании по санкционным спискам и спискам наблюдения
Документы	Сбор документов, OCR и перекрестная проверка
Ключевые лица	Определение бенефициарных владельцев и должностных лиц, AML и KYC

Статус каждой функции может быть: "Not Finished", "Approved", "Declined", "In Review" или "Resub Requested". Общий статус сессии складывается из статусов отдельных функций: сессия получает "Approved" только тогда, когда все обязательные функции одобрены.

События webhook

Бизнес-сессии генерируют следующие события webhook:

Событие	Триггер
`status.updated`	Статус сессии изменился. payload содержит `session_kind: "business"` для сессий KYB.
`data.updated`	Проверяющий изменил данные реестра или раздел Ключевые лица в консоли, либо реестр сообщил об изменении. payload содержит `session_kind: "business"`. Для отслеживания хода используйте `status.updated`.
`business.status.updated`	Изменился статус связанной сущности Business: `ACTIVE` / `FLAGGED` / `BLOCKED`.
`business.data.updated`	Изменились поля профиля связанной сущности Business или агрегированные счетчики.

payload webhook содержит session_kind: "business" и business_session_id, чтобы отличать эти события от событий верификации пользователей. Подробности о проверке подписи и доставке см. в разделе webhook.

Ключевые возможности

Возможность	Описание
Автоматические запросы к реестрам	Запросы к официальным реестрам компаний в поддерживаемых странах на уровне Lite, Shareholders или UBOs, стоимость которых зависит от страны
Определение UBO	Автоматическое извлечение структуры бенефициарного владения с долями участия
Проверка должностных лиц	Определение и проверка директоров, секретарей и других должностных лиц
AML компании	Проверка компании по санкционным спискам и спискам наблюдения
AML физических лиц	Индивидуальная проверка всех выявленных UBO и должностных лиц
Связывание KYC	Связывание каждого выявленного лица с сессией «Проверка пользователей» (KYC) для верификации личности
Сбор документов	Структурированные запросы документов с отслеживанием загрузки
Перекрёстная проверка данных с помощью OCR	Извлечение данных из загруженных документов и сверка с данными реестра
Бизнес-профили	Автоматическое создание профиля и агрегация сессий для каждой проверенной компании
Статусы на уровне функций	Независимое отслеживание статусов реестра, AML, документов и ключевых лиц
Оценка риска	Предупреждающие теги для каждой проверки и действия в сценарии, которые превращают статус компании, результаты AML и выводы о владении в итоговое решение
Webhook	Получение событий жизненного цикла сессии и обновления данных в реальном времени через webhook

Бизнес-сессии и пользовательские сессии

Параметр	Пользовательская сессия	Бизнес-сессия
Цель	Физическое лицо	Компания или юридическое лицо
Тип сессии	`user` (по умолчанию)	`business`
Основные проверки	ID, проверка живости, сравнение лиц, AML	Запрос к реестру, UBO, должностные лица, AML компании
Дополнительные проверки	Телефон, e-mail, подтверждение адреса, NFC	Сбор документов, AML физических лиц, связывание KYC
Payload webhook	Стандартные события сессии	Содержат `session_kind: "business"` и `business_session_id`

Следующие шаги

Бизнес-профили

Отслеживайте компании между сессиями с помощью профилей, тегов и массовых операций.

Данные о компании

Запросы к реестрам, статус компании и перекрестная сверка данных.

Структура владения

Определение UBO, корпоративные акционеры и цепочки владения.

Должностные лица и директора

Определение директоров, их ролей и связывание KYC.

AML-скрининг

Проверки AML на уровне компании и физических лиц.

Документы

Сбор документов, запросы и OCR-верификация.

Начало работы

Функции

Профили компаний

Справочник

Консоль

KYB API: верификация бизнеса, реестр и UBO в Didit

Как это работает

Жизненный цикл бизнес-сессии

Статусы функций

События webhook

Ключевые возможности

Бизнес-сессии и пользовательские сессии

Следующие шаги

Бизнес-профили

Данные о компании

Структура владения

Должностные лица и директора

AML-скрининг

Документы

​Как это работает

​Жизненный цикл бизнес-сессии

​Статусы функций

​События webhook

​Ключевые возможности

​Бизнес-сессии и пользовательские сессии

​Следующие шаги

Бизнес-профили

Данные о компании

Структура владения

Должностные лица и директора

AML-скрининг

Документы

Как это работает

Жизненный цикл бизнес-сессии

Статусы функций

События webhook

Ключевые возможности

Бизнес-сессии и пользовательские сессии

Следующие шаги