> ## Documentation Index
> Fetch the complete documentation index at: https://docs.didit.me/llms.txt
> Use this file to discover all available pages before exploring further.

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

> Верификация компаний через Didit: проверка реестров, выявление UBO, скрининг руководителей и AML. От $2.00 за проверку, по странам и тарифам, без контрактов.

Верификация бизнеса (KYB) в Didit позволяет проверять компании и юридические лица до их онбординга на платформе. Система автоматически запрашивает данные в реестрах компаний, определяет бенефициарных владельцев и должностных лиц, проверяет всех участников по спискам наблюдения AML и собирает подтверждающие документы, и всё это в рамках одного сценария. Каждая проверенная компания отслеживается как [бизнес-профиль](https://docs.didit.me/ru/business-verification/business-profiles.md), в котором объединяются результаты всех сессий.

Этот урок Didit Academy показывает весь путь проверки бизнеса: панель KYB, проверку по реестру, акционеров и UBO, AML-скрининг, а также то, что видит представитель компании со своей стороны.

[Верификация бизнеса (KYB): от начала до конца, Didit Academy](https://www.youtube.com/embed/JEnW_sEe35Y?rel=0\&playsinline=1)

Впервые работаете с Didit KYB? Начните с [быстрого старта](https://docs.didit.me/ru/business-verification/quickstart.md), который за 10 минут проведет вас через весь процесс, а затем изучите [руководство по интеграции](https://docs.didit.me/ru/business-verification/integration-guide.md) с типовыми схемами для продакшн-среды. Модель сущности Business, включая связи с пользователями, списками блокировки и импортом и экспортом, описана в разделе [Businesses](https://docs.didit.me/ru/entities/businesses/overview.md).

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

**1. Создание бизнес-сессии**

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

```bash theme={null}
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 автоматически создают бизнес-сессии с включенными функциями для бизнеса.

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

Didit запрашивает официальные реестры компаний на уровнях **Lite**, **Shareholders** или **UBOs**, каждый из которых оплачивается отдельно для каждой страны, см. [цены на проверку по реестрам](https://docs.didit.me/ru/getting-started/kyb-registry-pricing.md). Уровень Lite возвращает:

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

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

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

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

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

Один человек может иметь несколько ролей (например, директор **и** акционер). Каждая роль настраивается в сценарии отдельно: какие роли требуют KYC, какой KYC-сценарий использовать и может ли конечный пользователь пропустить верификацию. Подробнее в разделах [Ключевые лица](https://docs.didit.me/ru/business-verification/key-people.md) и [Структура владения](https://docs.didit.me/ru/business-verification/ownership.md).

**4. AML-скрининг**

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

* **AML компании**: проверяет саму компанию по санкционным спискам, негативным публикациям в СМИ и спискам регуляторных взысканий
* **AML-скрининг физического лица**: проверяет каждое ключевое лицо (UBO, акционера, директора, представителя и т. д.) по отдельности
* Использует ту же [систему оценки по двум показателям](https://docs.didit.me/ru/core-technology/aml-screening/overview.md) (оценка совпадения и оценка риска), что и верификация пользователей

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

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

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

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

**6. Проверка и решение**

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

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

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

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

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

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

Каждая сессия имеет уникальный `session_id`, последовательный `session_number` и `session_token` для ссылки на размещённую страницу верификации. Если сессия создается с идентификатором `vendor_data`, Didit автоматически связывает ее с соответствующим [бизнес-профилем](https://docs.didit.me/ru/business-verification/business-profiles.md).

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

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

| Функция | Описание |
| - | - |
| **Проверка реестра** | Запрос к реестру компаний и извлечение данных |
| **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](https://docs.didit.me/ru/entities/businesses/overview.md): `ACTIVE` / `FLAGGED` / `BLOCKED`. |
| `business.data.updated` | Изменились поля профиля связанной сущности Business или агрегированные счетчики. |

payload webhook содержит `session_kind: "business"` и `business_session_id`, чтобы отличать эти события от событий верификации пользователей. Подробности о проверке подписи и доставке см. в разделе [webhook](https://docs.didit.me/ru/integration/webhooks.md).

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

| Возможность | Описание |
| - | - |
| **Автоматические запросы к реестрам** | Запросы к официальным реестрам компаний в поддерживаемых странах на уровне Lite, Shareholders или UBOs, [стоимость которых зависит от страны](https://docs.didit.me/ru/getting-started/kyb-registry-pricing.md) |
| **Определение UBO** | Автоматическое извлечение структуры бенефициарного владения с долями участия |
| **Проверка должностных лиц** | Определение и проверка директоров, секретарей и других должностных лиц |
| **AML компании** | Проверка компании по санкционным спискам и спискам наблюдения |
| **AML физических лиц** | Индивидуальная проверка всех выявленных UBO и должностных лиц |
| **Связывание KYC** | Связывание каждого выявленного лица с сессией «Проверка пользователей» (KYC) для верификации личности |
| **Сбор документов** | Структурированные запросы документов с отслеживанием загрузки |
| **Перекрёстная проверка данных с помощью OCR** | Извлечение данных из загруженных документов и сверка с данными реестра |
| **Бизнес-профили** | Автоматическое создание профиля и агрегация сессий для каждой проверенной компании |
| **Статусы на уровне функций** | Независимое отслеживание статусов реестра, AML, документов и ключевых лиц |
| **Оценка риска** | Предупреждающие теги для каждой проверки и действия в сценарии, которые превращают статус компании, результаты AML и выводы о владении в итоговое решение |
| **Webhook** | Получение событий жизненного цикла сессии и обновления данных в реальном времени через [webhook](https://docs.didit.me/ru/integration/webhooks.md) |

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

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

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

> [card] [Бизнес-профили](https://docs.didit.me/ru/business-verification/business-profiles.md)
>
> Отслеживайте компании между сессиями с помощью профилей, тегов и массовых операций.

> [card] [Данные о компании](https://docs.didit.me/ru/business-verification/company-data.md)
>
> Запросы к реестрам, статус компании и перекрестная сверка данных.

> [card] [Структура владения](https://docs.didit.me/ru/business-verification/ownership.md)
>
> Определение UBO, корпоративные акционеры и цепочки владения.

> [card] [Должностные лица и директора](https://docs.didit.me/ru/business-verification/officers.md)
>
> Определение директоров, их ролей и связывание KYC.

> [card] [AML-скрининг](https://docs.didit.me/ru/business-verification/aml.md)
>
> Проверки AML на уровне компании и физических лиц.

> [card] [Документы](https://docs.didit.me/ru/business-verification/documents.md)
>
> Сбор документов, запросы и OCR-верификация.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.