> ## 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: постоянная запись KYC

> Пользователи Vendor — постоянная identity-запись Didit: история KYC, биометрия, документы, транзакции и статус блокировки в одном профиле.

**Сущность User** представляет одно физическое лицо (вашего клиента, конечного пользователя или заявителя) во всех проверках, транзакциях и комплаенс-взаимодействиях с вашей платформой Didit.

После создания User вся активность, связанная с тем же `vendor_data`, попадает в один и тот же профиль. Так вы получаете единое представление о личности, рисках и комплаенсе каждого человека.

## Что хранится в User

| Категория | Поля / объекты |
| - | - |
| **Личность** | `vendor_data`, `uuid`, `display_name`, `full_name`, `date_of_birth`, `portrait_image` |
| **Статус** | `ACTIVE`, `FLAGGED`, `BLOCKED` |
| **Агрегаты сессий** | `session_count`, `approved_count`, `declined_count`, `in_review_count`, карта `features` |
| **Проверенные контакты** | `approved_emails[]`, `approved_phones[]` |
| **География** | `issuing_states[]` (из проверенных документов, удостоверяющих личность) |
| **Активность** | `first_session_at`, `last_session_at`, `last_activity_at` |
| **Биометрия** | Прикреплённые записи о лицах (для поиска, обнаружения дубликатов и списка блокировки) |
| **Документы** | Удостоверения личности, подтверждения адреса и селфи из сессий |
| **Связи** | Связанные объекты Business (если пользователь является директором или UBO компаний, верифицированных в вашем приложении) |
| **Метаданные** | Произвольный JSON для ваших собственных данных |

Полную [модель данных User](https://docs.didit.me/ru/entities/users/data-model.md), включая типы, индексы и граничные случаи, см. здесь.

## Когда создаётся User

**1. Автоматически при первой сессии с новым vendor\_data**

Это типичный случай. Вы вызываете `POST /v3/session/` со значением `vendor_data`, которое Didit ещё не видел. Сущность User создаётся в статусе `ACTIVE` и привязывается к этой сессии.

**2. Явно через POST /v3/users/create/**

Вы создаёте User заранее, до запуска любой сессии. Это удобно для заполнения метаданных, задания начального статуса или массового онбординга клиентов из существующей базы данных.

**3. Из консоли**

Сотрудник комплаенса создаёт User на странице Users, например при онбординге клиента, которого проверили вручную.

## Что можно делать

| Операция | Как |
| - | - |
| [Список пользователей](https://docs.didit.me/ru/entities/users/operations.md#список-пользователей) | `GET /v3/users/` с фильтрами (статус, дата, страна) |
| [Получить пользователя](https://docs.didit.me/ru/entities/users/operations.md#получение-пользователя) | `GET /v3/users/{vendor_data}/` |
| [Создать пользователя](https://docs.didit.me/ru/entities/users/operations.md#создание-пользователя) | `POST /v3/users/create/` |
| [Обновить профиль](https://docs.didit.me/ru/entities/users/operations.md#обновление-пользователя) | `PATCH /v3/users/{vendor_data}/` |
| [Изменить статус](https://docs.didit.me/ru/entities/users/operations.md#изменение-статуса) | `PATCH /v3/users/{vendor_data}/update-status/` |
| [Удалить пользователей](https://docs.didit.me/ru/entities/users/operations.md#удаление-пользователей-пакетное) | `POST /v3/users/delete/` (пакетно) |
| [Прикрепить и искать лица](https://docs.didit.me/ru/entities/users/faces-and-biometrics.md) | Консоль и Lists API для списков блокировки |
| [Просмотреть документы](https://docs.didit.me/ru/entities/users/documents.md) | Через результаты решений по сессиям |
| [Добавить в список блокировки](https://docs.didit.me/ru/entities/users/blocklist.md) | Консоль и Lists API |
| [Просмотреть историю KYC](https://docs.didit.me/ru/entities/users/kyc-history.md) | `GET /v3/sessions?vendor_data=...` |
| [Просмотреть транзакции](https://docs.didit.me/ru/entities/users/transactions.md) | `GET /v3/transactions/?vendor_data=...` |
| [Импорт / экспорт](https://docs.didit.me/ru/entities/users/import-export.md) | Только в консоли (CSV) |
| [Управление в консоли](https://docs.didit.me/ru/entities/users/console.md) | Полное описание интерфейса |

## Users и Business

Один User может быть связан с одной или несколькими компаниями (Business). Например, один и тот же человек может быть директором одной компании и UBO другой. Didit сохраняет эти связи автоматически, когда [KYB](https://docs.didit.me/ru/business-verification/overview.md) выявляет людей по реестрам компаний.

## Связь User и сессии

```mermaid theme={null}
flowchart LR
    U[User entity<br/>vendor_data = user-42]
    S1["User Verification (KYC) session #1<br/>(approved 2025-01)"]
    S2["User Verification (KYC) session #2<br/>(resubmit, in review)"]
    S3["User Verification (KYC) session #3<br/>(re-verification 2026-01)"]
    S1 --> U
    S2 --> U
    S3 --> U
```

User агрегирует **последнее** состояние каждой функции по всем сессиям. Неудачная проверка `aml` в самой последней сессии отобразится в поле `features.aml` у User, даже если более ранние сессии были одобрены.

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

> [card] [Модель данных](https://docs.didit.me/ru/entities/users/data-model.md)
>
> Каждое поле, тип и индекс.

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

> [card] [Лица и биометрия](https://docs.didit.me/ru/entities/users/faces-and-biometrics.md)
>
> Прикрепление лица для поиска и добавления в список блокировки.

> [card] [Список блокировки](https://docs.didit.me/ru/entities/users/blocklist.md)
>
> Как работает добавление пользователей в список блокировки.

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

> [card] [Консоль](https://docs.didit.me/ru/entities/users/console.md)
>
> Полное описание интерфейса Users.


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