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

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

> Все поля сущности User в Didit: идентификация, статус, агрегаты KYC-сессий, биометрия, метки активности и метаданные. Оплата за использование.

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

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

| Поле | Тип | Описание |
| - | - | - |
| `uuid` | UUID | Первичный ключ, назначаемый Didit. Стабильный и уникальный. |
| `didit_internal_id` | string | Понятный человеку внутренний идентификатор (возвращается в ответах API). |
| `vendor_data` | string | Ваш идентификатор пользователя. Уникален в рамках приложения. [Подробнее](https://docs.didit.me/ru/entities/vendor-data-linking.md). |
| `display_name` | string | Имя, которое отображается в консоли и переопределяет стандартное. Если не задано, используется `full_name` или `vendor_data`. |
| `full_name` | string | Полное юридическое имя, перенесённое из документа, удостоверяющего личность, в последней одобренной сессии проверки пользователей (KYC). |
| `date_of_birth` | date (ISO 8601) | Перенесена из последней одобренной сессии проверки пользователей (KYC). |
| `portrait_image` | URL | Подписанный URL S3 для селфи из последней одобренной проверки живости. |

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

## Статус

| Поле | Тип | Значения | Описание |
| - | - | - | - |
| `status` | enum | `ACTIVE`, `FLAGGED`, `BLOCKED` | Определяет ограничения для будущих сессий и транзакций. См. [жизненный цикл](https://docs.didit.me/ru/entities/lifecycle.md). |

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

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

| Поле | Тип | Описание |
| - | - | - |
| `session_count` | int | Общее количество сессий, когда-либо созданных для этого пользователя |
| `approved_count` | int | Сессии, завершившиеся со статусом `APPROVED` |
| `declined_count` | int | Сессии, завершившиеся со статусом `DECLINED` |
| `in_review_count` | int | Сессии, которые сейчас имеют статус `IN_REVIEW` |
| `issuing_states[]` | массив кодов стран ISO | Страны выдачи всех документов, удостоверяющих личность, проверенных в сессиях |
| `approved_emails[]` | массив строк | Адреса электронной почты, подтверждённые через [Проверку электронной почты](https://docs.didit.me/ru/core-technology/email-verification/overview.md) |
| `approved_phones[]` | массив строк | Номера телефонов, подтверждённые через [Проверку телефона](https://docs.didit.me/ru/core-technology/phone-verification/overview.md) |
| `features` | object | Последний статус каждой функции во всех сессиях |

### Словарь `features`

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

```json theme={null}
{
  "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](https://docs.didit.me/ru/management-api/lists/overview.md): фильтрация записей по идентификаторам пользователя |

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

```json theme={null}
{
  "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" }
}
```

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

> [card] [Операции](https://docs.didit.me/ru/entities/users/operations.md)
>
> Создание, обновление, изменение статуса, удаление.

> [card] [История KYC](https://docs.didit.me/ru/entities/users/kyc-history.md)
>
> Получение всех сессий, связанных с пользователем.

> [card] [Справочник API](https://docs.didit.me/ru/management-api/users/get.md)
>
> Схема GET /v3/users/{vendor_data}/.


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