Модель данных пользователя: схема пользователя vendor

Эта страница описывает все поля сущности User. Поля делятся на пять групп: идентификация, статус, агрегаты сессий, временные метки активности и метаданные.

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

Поле	Тип	Описание
`uuid`	UUID	Первичный ключ, назначаемый Didit. Стабильный и уникальный.
`didit_internal_id`	string	Понятный человеку внутренний идентификатор (возвращается в ответах API).
`vendor_data`	string	Ваш идентификатор пользователя. Уникален в рамках приложения. Подробнее.
`display_name`	string	Имя, которое отображается в консоли и переопределяет стандартное. Если не задано, используется `full_name` или `vendor_data`.
`full_name`	string	Полное юридическое имя, перенесённое из документа, удостоверяющего личность, в последней одобренной сессии проверки пользователей (KYC).
`date_of_birth`	date (ISO 8601)	Перенесена из последней одобренной сессии проверки пользователей (KYC).
`portrait_image`	URL	Подписанный URL S3 для селфи из последней одобренной проверки живости.

full_name, date_of_birth и portrait_image доступны только для чтения, если они получены из верифицированной сессии. Вы можете переопределить их в консоли или через PATCH /v3/users/{vendor_data}/, но ручные переопределения помечаются в журнале аудита.

Статус

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

Агрегаты сессий

Эти поля вычисляются Didit и обновляются в реальном времени по мере завершения сессий.

Поле	Тип	Описание
`session_count`	int	Общее количество сессий, когда-либо созданных для этого пользователя
`approved_count`	int	Сессии, завершившиеся со статусом `APPROVED`
`declined_count`	int	Сессии, завершившиеся со статусом `DECLINED`
`in_review_count`	int	Сессии, которые сейчас имеют статус `IN_REVIEW`
`issuing_states[]`	массив кодов стран ISO	Страны выдачи всех документов, удостоверяющих личность, проверенных в сессиях
`approved_emails[]`	массив строк	Адреса электронной почты, подтверждённые через Проверку электронной почты
`approved_phones[]`	массив строк	Номера телефонов, подтверждённые через Проверку телефона
`features`	object	Последний статус каждой функции во всех сессиях

Словарь `features`

Каждая сессия выполняет одну или несколько функций (верификация личности, проверка живости, сравнение лиц, AML, POA, NFC и другие). Словарь features хранит последний статус каждой функции для этого пользователя:

{
  "id_verification": "APPROVED",
  "liveness": "APPROVED",
  "face_match": "APPROVED",
  "aml": "IN_REVIEW",
  "proof_of_address": "APPROVED",
  "nfc_verification": "NOT_FINISHED"
}

Статусы функций: NOT_FINISHED, APPROVED, DECLINED, IN_REVIEW, EXPIRED, ABANDONED, RESUB_REQUESTED. Используйте словарь features как быстрый способ ответить на вопрос «полностью ли верифицирован этот пользователь прямо сейчас», не перебирая все сессии.

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

Поле	Тип	Обновляется, когда
`first_session_at`	временная метка ISO	Создана первая сессия
`last_session_at`	временная метка ISO	Создана или обновлена последняя сессия
`last_activity_at`	временная метка ISO	Любое изменение: сессия, транзакция, статус, профиль, заметки, теги
`created_at`	временная метка ISO	Создана запись сущности
`updated_at`	временная метка ISO	В последний раз обновлена запись сущности

Метаданные

Поле	Тип	Описание
`metadata`	object (JSON)	Произвольный JSON, который вы контролируете. Используйте для внутренних тегов, уровня, источника регистрации и т. д.
`tags[]`	массив	Теги, управляемые через консоль или API, для фильтрации и группировки

Метаданные не имеют схемы: Didit сохраняет всё, что вы записываете.

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

Связь	Как получить доступ
Сессии	`GET /v3/sessions?vendor_data=<value>`
Транзакции (как заявитель)	`GET /v3/transactions/?vendor_data=<value>`
Транзакции (как контрагент)	Отфильтруйте список транзакций по vendor_data контрагента в консоли
Связанные компании (директор / UBO)	Отображаются на странице сведений о пользователе в консоли
Биометрия лица	Консоль и Lists API
Записи в списке блокировки	Lists API: фильтрация записей по идентификаторам пользователя

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

{
  "uuid": "9c7d2a30-2f98-4d4f-9d2d-1a7c4b1e5b6a",
  "didit_internal_id": "U-2026-00042",
  "vendor_data": "user-42",
  "display_name": "Jane Doe",
  "full_name": "John Doe",
  "date_of_birth": "1990-01-01",
  "portrait_image": "https://<media-host>/...",
  "status": "ACTIVE",
  "session_count": 3,
  "approved_count": 2,
  "declined_count": 0,
  "in_review_count": 1,
  "issuing_states": ["US", "ES"],
  "approved_emails": ["jane@example.com"],
  "approved_phones": ["+14155550123"],
  "features": {
    "id_verification": "APPROVED",
    "liveness": "APPROVED",
    "face_match": "APPROVED",
    "aml": "IN_REVIEW"
  },
  "first_session_at": "2025-03-01T12:00:00Z",
  "last_session_at": "2026-04-10T09:00:00Z",
  "last_activity_at": "2026-04-16T10:00:00Z",
  "metadata": { "tier": "premium" }
}

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

Операции

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

История KYC

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

Справочник API

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

Обзор

Цены

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

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

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

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

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

Didit Academy

Ресурсы

Модель данных пользователя: схема пользователя vendor

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

Статус

Агрегаты сессий

Словарь `features`

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

Метаданные

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

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

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

Операции

История KYC

Справочник API

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

​Статус

​Агрегаты сессий

​Словарь features

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

​Метаданные

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

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

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

Операции

История KYC

Справочник API

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

Статус

Агрегаты сессий

Словарь `features`

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

Метаданные

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

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

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