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

История KYC пользователя: сессии и повторная верификация

Получите все сессии верификации Didit, привязанные к сущности User: результаты по функциям, повторная верификация и экспорт отчётов для комплаенса.

Каждая сессия проверки пользователей (KYC), которую когда-либо проходил пользователь, навсегда остаётся связанной с его сущностью User. Вы можете получить полную историю, изучить результаты отдельных сессий, инициировать повторную верификацию и экспортировать отчёты о соответствии требованиям.

Просмотр всех сессий пользователя

Отфильтруйте список сессий по vendor_data:

curl -G https://verification.didit.me/v3/sessions/ \
  -H "x-api-key: YOUR_API_KEY" \
  --data-urlencode "vendor_data=user-42" \
  --data-urlencode "page_size=50"

Ответ включает все сессии независимо от статуса: одобренные, отклонённые, на проверке, прерванные или с истёкшим сроком действия.

Понимание агрегатов функций

Карта features сущности User отражает последний статус каждой функции по всем сессиям:

"features": {
  "id_verification": "APPROVED",
  "liveness": "APPROVED",
  "face_match": "APPROVED",
  "aml": "IN_REVIEW"
}

Используйте её для быстрого ответа на вопрос «пользователь сейчас верифицирован?». Для полной истории (все сессии, все функции, все результаты) получите список сессий и изучите решение по каждой из них.

Просмотр отдельной сессии

curl https://verification.didit.me/v3/session/{session_id}/decision/ \
  -H "x-api-key: YOUR_API_KEY"

Решение включает:

Результаты по каждой функции (ID, проверка живости, сравнение лиц, AML, подтверждение адреса (POA), NFC и т. д.)
Извлечённые данные документа и изображения (подписанные URL)
Совпадения AML с оценками совпадения и риска
Анализ устройства и IP, а также контекст устройства
Заметки проверяющего и ручные действия

Полную схему см. в разделе получение сессии.

Инициирование повторной верификации

Когда пользователю нужно пройти верификацию повторно (например, ежегодный повторный KYC, истечение срока действия документа, проверка по триггеру):

curl -X POST https://verification.didit.me/v3/session/ \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "workflow_id": "wf_reverification",
    "vendor_data": "user-42"
  }'

Новая сессия привязывается к той же сущности User. После её завершения карта features сущности обновляется с учётом новых результатов.

Повторная отправка или новая сессия

Сценарий	Что использовать
Сессия пользователя отклонена из-за исправимой проблемы (размытый документ, плохое освещение)	Повторная отправка: та же сессия, новая загрузка
Полная повторная верификация или периодический повторный KYC	Создайте новую сессию
Исправление, инициированное правилом для транзакции	Транзакция автоматически создаёт сессию для устранения проблемы (статус `AWAITING_USER`)

Экспорт отчёта о соответствии требованиям

Для аудитов, SAR или запросов регулятора создайте PDF для любой сессии:

curl https://verification.didit.me/v3/session/{session_id}/generate-pdf/ \
  -H "x-api-key: YOUR_API_KEY" \
  -o session-report.pdf

Чтобы получить всю историю пользователя в одном файле, скачайте PDF истории пользователя. Он включает титульную страницу (сводка профиля, статус функций, индекс сессий), за которой следует полный отчёт по каждой сессии, подлежащей отчётности, от самой старой к самой новой, но не более 20 последних.

curl --fail https://verification.didit.me/v3/users/user-42/generate-pdf/ \
  -H "x-api-key: YOUR_API_KEY" \
  -o user-history.pdf

Это тот же документ, который консоль создаёт через Users → [user] → Actions → Download PDF. Для массового экспорта CSV по многим пользователям используйте экспорт для всего приложения в разделе Review & Operations → Export PDF/CSV.

Передача сессии третьей стороне

Если нужно передать верификацию пользователя партнёрскому приложению (например, в сценарии многоразового KYC), используйте:

POST /v3/session/{session_id}/share/ — создаёт токен для передачи.
POST /v3/session/import-shared/ — импортирует переданную сессию на стороне получателя.

Подробнее о схеме см. в разделе многоразовый KYC.

Сценарии, управляемые историей

Используйте историю сессий для более точных решений в области комплаенса:

Пропускайте шаги, если у пользователя уже есть одобренная проверка живости за последние N дней.
Требуйте дополнительные проверки, если его последняя сессия отклонена.
Помечайте, когда количество сессий пользователя неожиданно резко возрастает.
Отслеживайте постоянные повторные проверки AML через функцию постоянного мониторинга.

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

Модель данных

Как рассчитываются карта функций и счётчики.

Получение сессии

Полная схема решения по сессии.

Многоразовый KYC

Повторное использование проверенных данных в разных приложениях.

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

Обзор

Цены

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

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

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

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

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

Didit Academy

Ресурсы

История KYC пользователя: сессии и повторная верификация

Просмотр всех сессий пользователя

Понимание агрегатов функций

Просмотр отдельной сессии

Инициирование повторной верификации

Повторная отправка или новая сессия

Экспорт отчёта о соответствии требованиям

Передача сессии третьей стороне

Сценарии, управляемые историей

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

Модель данных

Получение сессии

Многоразовый KYC

​Просмотр всех сессий пользователя

​Понимание агрегатов функций

​Просмотр отдельной сессии

​Инициирование повторной верификации

​Повторная отправка или новая сессия

​Экспорт отчёта о соответствии требованиям

​Передача сессии третьей стороне

​Сценарии, управляемые историей

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

Модель данных

Получение сессии

Многоразовый KYC

Просмотр всех сессий пользователя

Понимание агрегатов функций

Просмотр отдельной сессии

Инициирование повторной верификации

Повторная отправка или новая сессия

Экспорт отчёта о соответствии требованиям

Передача сессии третьей стороне

Сценарии, управляемые историей

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