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

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

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

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

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

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

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

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

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

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

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

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

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 создаётся в момент начала сессии.

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

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

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" }'

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

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

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

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

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

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

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

Подробные инструкции находятся в разделах Пользователи и Компании.

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

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

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

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

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

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

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

Подробнее о переходах между статусами и событиях webhook см. в разделе жизненный цикл объекта.

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

Жизненный цикл

Состояния, переходы и события жизненного цикла для каждого объекта.

Связывание через vendor_data

Как vendor_data связывает сессии, транзакции и объекты.

Пользователи

Подробно об объектах «Пользователь», операциях и процессах в консоли.

Компании

Подробно об объектах «Компания», операциях и процессах в консоли.

Webhook объектов

События в реальном времени для каждого изменения объекта.

Список блокировки

Как записи списка блокировки взаимодействуют с объектами «Пользователь» и «Компания».

Обзор

Цены

Сценарии и верификация

Проверка и операции