Модель данных компании: схема KYB

Этот раздел описывает все поля сущности компании и то, как Didit заполняет каждое из них.

Поля идентификации

Поле	Тип	Описание
`uuid`	UUID	Первичный ключ, назначаемый Didit. Стабилен и уникален.
`didit_internal_id`	string	Внутренний идентификатор, понятный человеку.
`vendor_data`	string	Ваш идентификатор компании. Уникален в рамках приложения. Подробнее.
`display_name`	string	Переопределяемое название, отображаемое в консоли. По умолчанию используется `legal_name` или `vendor_data`.
`legal_name`	string	Юридическое название компании согласно регистрации. Берётся из результата поиска в реестре в последней одобренной сессии верификации бизнеса (KYB).
`registration_number`	string	Официальный регистрационный номер компании. Берётся из реестра.
`country_code`	string (ISO 3166-1 alpha-3)	Страна регистрации компании.

legal_name, registration_number и country_code доступны только для чтения, если они получены из проверенного результата поиска в реестре. Их можно переопределить вручную в консоли или через PATCH /v3/businesses/{vendor_data}/, но каждое переопределение отмечается в журнале аудита.

Статус

Поле	Тип	Значения	Описание
`status`	enum	`ACTIVE`, `FLAGGED`, `BLOCKED`	Определяет правила применения для будущих сессий и транзакций. См. жизненный цикл.

Агрегированные поля сессий

Поле	Тип	Описание
`session_count`	int	Общее количество сессий верификации бизнеса (KYB), когда-либо созданных для этой компании
`approved_count`	int	Сессии, завершённые со статусом `Approved`
`declined_count`	int	Сессии, завершённые со статусом `Declined`
`in_review_count`	int	Сессии, которые сейчас имеют статус `In Review`
`features`	object	Статус последней проверки компании, под ключом `KYB`

Карта `features`

{
  "KYB": "Approved"
}

Карта содержит один ключ, KYB, со статусом последней проверки компании: "Not Finished", "Approved", "Declined", "In Review" или "Resub Requested". Чтобы узнать статус каждой отдельной функции KYB, смотрите решение по сессии. Используйте карту features для быстрой проверки того, полностью ли верифицирована компания прямо сейчас, без перебора всех сессий.

Временные метки активности

Поле	Тип	Когда обновляется
`first_session_at`	ISO timestamp	Создана первая сессия верификации бизнеса (KYB)
`last_session_at`	ISO timestamp	Создана или обновлена последняя сессия
`last_activity_at`	ISO timestamp	При любом изменении сессии, транзакции, статуса, профиля или заметок
`created_at`	ISO timestamp	Создана запись сущности
`updated_at`	ISO timestamp	Последнее обновление записи сущности

Метаданные

Поле	Тип	Описание
`metadata`	object (JSON)	Произвольный JSON, которым управляете вы
`tags[]`	array	Теги, которыми управляют консоль и API

Связи (не хранятся в строке компании)

Связь	Как получить доступ
Сессии верификации бизнеса (KYB)	`GET /v3/sessions?vendor_data=<value>`
Связанные пользователи (руководители, UBO, директора)	Отображаются на странице сведений о компании в консоли; берутся из последней одобренной сессии верификации бизнеса (KYB)
Транзакции (как заявитель или контрагент)	Фильтруйте транзакции по `vendor_data` компании
Документы	Через решения по сессиям верификации бизнеса (KYB)
AML-срабатывания	Через решения по сессиям верификации бизнеса (KYB)

Пример ответа

{
  "uuid": "f7a9c1b2-4e6d-4f8a-9c5d-2a1b3c4d5e6f",
  "didit_internal_id": "B-2026-00018",
  "vendor_data": "biz-acme",
  "display_name": "Acme Corp",
  "legal_name": "Acme Corporation Limited",
  "registration_number": "12345678",
  "country_code": "GBR",
  "status": "ACTIVE",
  "session_count": 2,
  "approved_count": 1,
  "declined_count": 0,
  "in_review_count": 1,
  "features": {
    "KYB": "Approved"
  },
  "first_session_at": "2025-09-01T12:00:00Z",
  "last_session_at": "2026-04-01T09:00:00Z",
  "last_activity_at": "2026-04-16T10:00:00Z",
  "metadata": { "partner": "Acme Holdings" }
}

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

Операции

Создание, обновление, изменение статуса, удаление.

История KYB

Получение всех сессий, связанных с компанией.

Справочник API

Схема GET /v3/businesses//.

Последнее изменение 7 ноября 2026 г.

Обзор

Цены

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

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

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

Настройки и кастомизация

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

Didit Academy

Ресурсы

Модель данных компании: схема KYB

Поля идентификации

Статус

Агрегированные поля сессий

Карта `features`

Временные метки активности

Метаданные

Связи (не хранятся в строке компании)

Пример ответа

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

Операции

История KYB

Справочник API

​Поля идентификации

​Статус

​Агрегированные поля сессий

​Карта features

​Временные метки активности

​Метаданные

​Связи (не хранятся в строке компании)

​Пример ответа

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

Операции

История KYB

Справочник API

Поля идентификации

Статус

Агрегированные поля сессий

Карта `features`

Временные метки активности

Метаданные

Связи (не хранятся в строке компании)

Пример ответа

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