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

# Сущности: пользователи и компании в Didit

> Пользователи и компании — две основные сущности Didit. Каждая объединяет KYC-сессии, транзакции, документы, биометрию и риски в один профиль.

Didit организует всё, что происходит в вашем приложении, вокруг двух основных типов объектов:

| Объект | Что представляет | Связан с |
| - | - | - |
| **Пользователь** | Отдельного человека | Сессиями проверки пользователей (KYC), биометрией лица, транзакциями (как заявитель или контрагент), списками блокировки |
| **Компания** | Юридическое лицо (компанию, LLC, индивидуальное предпринимательство, фонд) | Сессиями верификации бизнеса (KYB), должностными лицами, бенефициарными владельцами (UBO), транзакциями (как заявитель или контрагент), списками блокировки |

Каждая сессия проверки, каждая транзакция и каждая запись в списке блокировки может быть привязана к объекту. После привязки объект становится постоянным профилем, который агрегирует историю, сигналы риска и состояние комплаенса во времени.

## Объект и сессия

**Объект** и **сессия** являются разными понятиями.

| Понятие | Охват | Срок жизни | Пример |
| - | - | - | - |
| **Сессия** | Одно событие проверки | Один процесс (от нескольких минут до нескольких дней, пока сессия находится на проверке) | Одна попытка KYC |
| **Объект** | Постоянный профиль | Существует, пока пользователь или компания существует на вашей платформе | Клиент «Jane Doe» с 3 сессиями проверки пользователей (KYC) за 2 года |

У одного объекта может быть много сессий: повторные проверки, повторные отправки, дополнительные проверки, периодический мониторинг в рамках постоянного мониторинга. Объект агрегирует результаты.

## Автосоздание и предварительное создание вручную

Объекты создаются одним из трёх способов:

**1. Автоматически создаётся из сессии**

Когда вы создаёте сессию с идентификатором `vendor_data`, а подходящего объекта не существует, Didit создаёт объект автоматически. Это самый распространённый путь.

```bash theme={null}
curl -X POST https://verification.didit.me/v3/session/ \
  -H "x-api-key: YOUR_API_KEY" \
  -d '{ "workflow_id": "wf_kyc_standard", "vendor_data": "user-42" }'
```

Объект «Пользователь» для `user-42` создаётся в момент начала сессии.

**2. Создаётся заранее через Management API**

Сначала создайте объект, а затем запускайте сессии для него. Это полезно, когда нужно задать сигналы риска (статус, теги, пользовательские метаданные) до первой проверки.

```bash theme={null}
curl -X POST https://verification.didit.me/v3/users/create/ \
  -H "x-api-key: YOUR_API_KEY" \
  -d '{ "vendor_data": "user-42", "display_name": "Jane Doe" }'
```

**3. Создаётся в консоли**

Ваша команда комплаенса может создавать пользователей или компании напрямую в Business Console. Это удобно для ручного онбординга, импорта или процессов устранения нарушений.

## Как объекты связывают всё между собой

Поле `vendor_data` — это ключ связывания. Когда вы передаёте `vendor_data` в любой сессии или транзакции, Didit направляет его к подходящему объекту.

```mermaid theme={null}
flowchart LR
    VD["vendor_data:<br/>user-42"] --> U[User entity]
    S1[User Verification (KYC) session #1] --> VD
    S2[User Verification (KYC) session #2] --> VD
    T1[Transaction #1] --> VD
    T2[Transaction #2] --> VD
    F[Face biometric] --> VD
    D[Documents] --> VD
    BL[Blocklist entry] --> VD
```

Подробнее читайте в [руководстве по связыванию через `vendor_data`](https://docs.didit.me/ru/entities/vendor-data-linking).

## Что можно делать с объектом

Для каждого объекта «Пользователь» или «Компания» вы можете:

| Операция | Назначение |
| - | - |
| **Создание / обновление** | Задать или изменить данные профиля (имя, страну, пользовательские метаданные) |
| **Изменить статус** | Установить `ACTIVE`, `FLAGGED` или `BLOCKED`. Применение распространяется на будущие сессии и транзакции |
| **Прикрепить биометрию** | Загрузить эталонное изображение лица для поиска 1:N, выявления дубликатов или внесения в список блокировки |
| **Просмотреть историю KYC/KYB** | Получить все сессии, связанные с объектом, с результатами по каждой функции |
| **Просмотреть историю транзакций** | Получить все транзакции, в которых объект является заявителем или контрагентом |
| **Добавить в список блокировки** | Блокировать будущие сессии или транзакции с участием этого объекта |
| **Импорт / экспорт** | Массово загрузить объекты из CSV или экспортировать их для внешних инструментов комплаенса |
| **Удалить** | Удалить объект (история сохраняется для аудита) |

Подробные инструкции находятся в разделах [Пользователи](https://docs.didit.me/ru/entities/users/overview.md) и [Компании](https://docs.didit.me/ru/entities/businesses/overview.md).

## Связи Пользователь ↔ Компания

Один пользователь может быть связан с одной или несколькими компаниями. Это естественно происходит в ходе KYB:

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

Didit сохраняет эти связи: при просмотре объекта «Компания» вы видите всех связанных пользователей, а при просмотре объекта «Пользователь» видите все компании, с которыми он связан.

## Жизненный цикл и статусы

У каждого объекта есть статус, который определяет, блокирует ли Didit новую активность:

| Статус | Влияние |
| - | - |
| `ACTIVE` | Обычный режим: сессии и транзакции проходят согласно настройкам сценариев и правил |
| `FLAGGED` | Сессии и транзакции разрешены, но автоматически направляются на ручную проверку |
| `BLOCKED` | Сессии и транзакции автоматически отклоняются, создать новые сессии нельзя |

Подробнее о переходах между статусами и событиях webhook см. в разделе [жизненный цикл объекта](https://docs.didit.me/ru/entities/lifecycle.md).

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

> [card] [Жизненный цикл](https://docs.didit.me/ru/entities/lifecycle.md)
>
> Состояния, переходы и события жизненного цикла для каждого объекта.

> [card] [Связывание через vendor\_data](https://docs.didit.me/ru/entities/vendor-data-linking.md)
>
> Как `vendor_data` связывает сессии, транзакции и объекты.

> [card] [Пользователи](https://docs.didit.me/ru/entities/users/overview.md)
>
> Подробно об объектах «Пользователь», операциях и процессах в консоли.

> [card] [Компании](https://docs.didit.me/ru/entities/businesses/overview.md)
>
> Подробно об объектах «Компания», операциях и процессах в консоли.

> [card] [Webhook объектов](https://docs.didit.me/ru/entities/webhooks.md)
>
> События в реальном времени для каждого изменения объекта.

> [card] [Список блокировки](https://docs.didit.me/ru/console/blocklist-users.md)
>
> Как записи списка блокировки взаимодействуют с объектами «Пользователь» и «Компания».


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