> ## 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.

# Бенефициарные владельцы (UBO): API извлечения

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

Главная задача KYB состоит в том, чтобы установить, кто в конечном счёте владеет компанией и контролирует её. Didit получает структуру владения из реестра, если он доступен, позволяет администратору бизнеса подтвердить и дополнить её в размещённом процессе, а затем проводит верификацию каждого ключевого лица с учётом его роли.

## Бенефициарные владельцы (UBO)

**Конечный бенефициарный владелец (UBO)** — это физическое лицо, которое в конечном счёте владеет юридическим лицом или контролирует его. UBO отображаются в решении по сессии в `key_people_checks[].registry.beneficial_owners[]` (полученные из реестра) и `key_people_checks[].submitted.parties[]` (указанные пользователем); в этом же списке отображаются и другие роли, например акционер или директор.

## Данные, которые собираются по каждому ключевому лицу

Размещённая страница верификации собирает набор полей по умолчанию и дополнительные поля, настроенные в сценарии. Поля по умолчанию:

| Поле | Физическое лицо | Компания |
| - | :-: | :-: |
| `name` или `first_name` + `last_name` | ✅ обязательно | ✅ обязательно (`company_name`) |
| `email` | ✅ обязательно | ✅ обязательно |
| `nationality` / страна | ✅ обязательно | ✅ обязательно |
| `role` (одна или несколько для каждой стороны) | ✅ обязательно | ✅ обязательно |
| `ownership_percent` / `voting_percent` (для каждой роли) | необязательно | необязательно |
| `date_of_birth` | необязательно | не применяется |
| `phone_number` | необязательно | не применяется |
| `position` (свободный текст, должность) | необязательно | не применяется |
| `registration_number` | не применяется | необязательно |
| `entity_type` | `person` | `company` |

`entity_type` заполняется автоматически в зависимости от того, является ли сторона физическим лицом или юридическим лицом.

### Дополнительные поля

В сценариях можно потребовать дополнительные поля для каждого физического лица или каждой компании, и количество таких полей не ограничено. Их настраивают в Business Console в сценарии KYB, а значения попадают в объект `custom_fields` каждой стороны в ответе с решением. Дополнительные поля удобно использовать для деклараций об источнике благосостояния, налогового резидентства, внутренних идентификаторов клиентов или раскрытия информации, специфичной для отрасли.

## Корпоративные акционеры и многоуровневое владение

Если акционер сам является компанией, а не физическим лицом, Didit записывает:

* Название компании и регистрационный номер.
* Процент владения, который принадлежит этому корпоративному акционеру.
* Страну учреждения.

Это позволяет проследить цепочку через несколько уровней до конечных физических лиц.

### Вложенный KYB для корпоративных UBO

Если сценарий включает вложенный KYB для корпоративных UBO, каждая корпоративная сторона запускает собственную дочернюю подсессию KYB: компания проходит верификацию по тому же процессу, что и на верхнем уровне, а её результат передаётся в родительскую сессию. По умолчанию эта функция выключена, её включают для каждого сценария отдельно.

## Пороги владения

В большинстве юрисдикций UBO определяется при владении **от 25% и выше**. Порог настраивается для каждого сценария:

| Юрисдикция | Типичный порог UBO |
| - | - |
| ЕС (AMLD) | 25% владения или контроля |
| Великобритания | 25% акций или прав голоса |
| США (CTA) | 25% владения или существенный контроль |
| Сингапур | 25% акций или прав голоса |

Задайте порог в разделе *Workflows → \[KYB workflow] → Risk → UBO threshold*. Сценарий также может помечать или направлять на проверку случаи, когда ни один UBO не достигает порога (это типично для публичных компаний с широким распределением акций).

## Права голоса и экономические права

Раскрытие структуры владения различает два вида контроля:

| Право | Что это означает |
| - | - |
| **Экономический (долевой) %** | Доля в экономической стоимости компании или в правах на дивиденды |
| **Доля голосов, %** | Доля голосов на решениях собрания акционеров |

Обычно эти значения совпадают, но могут различаться, если компания выпускает акции разных классов или привилегированные акции. Didit записывает оба значения. Правила и пороги могут проверять любое из них: в большинстве юрисдикций раскрытие UBO обязательно, когда хотя бы один из показателей достигает 25%.

## Эффективное владение через цепочку

Если владение идёт через корпоративного акционера, эффективное владение конечным физическим лицом вычисляется перемножением процентов по всей цепочке.

### Пример: цепочка из трёх уровней

```
Acme Corp (target)
  └─ 60% → Acme Holdings Ltd
              └─ 75% → Jane Doe (natural person)
  └─ 40% → John Smith (natural person)
```

Вычисленные UBO:

* **Jane Doe**: эффективное владение Acme Corp = 60% × 75% = **45%** (UBO).
* **John Smith**: эффективное владение Acme Corp = **40%** (UBO).

При пороге UBO 25% раскрываются и Jane, и John. При пороге 50% ни один из них не достигает границы, и Didit помечает это как проблему прозрачности.

## Как настройки ролей влияют на верификацию

Каждая роль настраивается отдельно для каждого сценария KYB: включена она или выключена, требуется ли для неё KYC, какой сценарий KYC использовать для этой роли и может ли конечный пользователь отказаться от неё. Когда отправляется ключевое лицо:

1. Didit сверяет роли отправленной стороны с настройками ролей сценария.
2. Для ролей, которые требуют верификации, запускается дочерняя сессия верификации:
   * **Физические лица** → дочерняя сессия «Проверка пользователей» (KYC), которая использует либо сценарий KYC для конкретной роли, либо сценарий по умолчанию.
   * **Корпоративные UBO** (если включён вложенный KYB) → дочерняя подсессия «Верификация бизнеса» (KYB).
3. Для ролей, которые можно пропустить, конечный пользователь видит вариант «пропустить верификацию» и может отказаться от неё; пропущенные стороны записываются, но не блокируют родительскую сессию.
4. Стороны, доля владения которых ниже порога, установленного сценарием, не запускают индивидуальную верификацию, даже если их роль обычно её требует.

Все настройки выполняются в Business Console в разделе *Workflows → \[KYB workflow] → Key People*.

## Мониторинг акционеров и UBO

> [!NOTE]
>
> Мониторинг реестра **скоро будет доступен**. Ни в одной стране из каталога розничных реестров в стейджинге, проверенного 7 сентября 2026 г., мониторинг не включён. Настроенная стоимость составляет USD 2.00 за компанию в год, но наличие цены не означает, что функция доступна. Описанное ниже поведение относится к запланированному сервису после запуска.

Компания, верифицированная на уровне **Акционеры** или **UBO**, может находиться под **постоянным мониторингом реестра**. Реестр передаёт изменения статуса компании, должностных лиц, структуры владения и юридического адреса. При каждом изменении Didit:

* переводит сессию компании из статуса *«Одобрена»* обратно в статус *«На проверке»* и фиксирует изменение в сессии;
* отправляет [webhook](https://docs.didit.me/ru/business-verification/webhooks.md) `data.updated` с `trigger: "kyb_registry_change"`;
* поддерживает запись реестра компании в актуальном состоянии.

Мониторинг **доступен только в странах, где это разрешено**: провайдер реестра должен предоставлять мониторинг для данной юрисдикции. Полный список приведён в [таблице стран с постоянным мониторингом](https://docs.didit.me/ru/business-verification/supported-countries.md#непрерывный-мониторинг-реестров). Компания, верифицированная на уровне Lite или в стране вне этого списка, не подключается к мониторингу, а на странице компании указывается причина.

Включите его для каждого сценария в разделе *Workflows → KYB Registry Check → Advanced → Continuous registry monitoring*. Он стоит **\$2.00 за компанию в год** и списывается при подключении и при каждом ежегодном продлении. Если на кошельке недостаточно средств для продления, мониторинг для этой компании останавливается, а не работает без оплаты. Отключить его можно в любой момент на странице компании (*KYB Registry Check → Registry monitoring*).

## Сверка данных реестра и данных, переданных пользователем

Ответ показывает оба источника рядом в `key_people_checks[]`:

* `registry.officers[]` и `registry.beneficial_owners[]` содержат то, что раскрыл провайдер.
* `submitted.parties[]` содержит то, что администратор компании явно передал через сценарий, с `source: "USER"`.

Аналитики визуально сравнивают два набора в консоли, чтобы найти пропущенных UBO, лишних нераскрытых участников или доли владения, которые не совпадают. Автоматического эндпоинта для сравнения нет. Сверку можно провести на вашей стороне, сопоставляя записи по имени, роли и доле владения, где это применимо.

## AML-скрининг

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

## Дальнейшие шаги

> [card] [Ключевые лица](https://docs.didit.me/ru/business-verification/key-people.md)
>
> Сценарий работы с ключевыми лицами от начала до конца.

> [card] [Должностные лица и представители](https://docs.didit.me/ru/business-verification/officers.md)
>
> Управленческие роли в модели ключевых лиц.

> [card] [Оценка рисков](https://docs.didit.me/ru/business-verification/risk-assessment.md)
>
> Что определяет результат KYB.


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