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

# Документы пользователей: ID и подтверждение адреса

> Документы, подтверждение адреса и доп. файлы пользователей Didit: что собирается, как получить и загрузить через консоль.



Промпт для документов пользователя
        Скопировать промпт в буфер обмена



      
      

\<pre>

\````# Goal — retrieve user documents and generate compliance PDFs

Documents (ID images, MRZ data, selfies, proof-of-address scans, NFC chip reads) are attached to the **session** that captured them, not directly to the User entity. There is no public "upload document to user" API — capture flows through sessions. You can however list sessions for the user, retrieve each session's decision, and pull signed URLs to the document images.

\## Pattern — list sessions for a user, then read each decision

\```bash
\# 1) List sessions tied to the User entity
curl -G https://verification.didit.me/v3/sessions/ \
-H "x-api-key: $DIDIT_API_KEY" \
\--data-urlencode "vendor_data=user-42" \
\--data-urlencode "page_size=50"

\# 2) For each session, retrieve the full decision (V3 plural arrays)
curl https://verification.didit.me/v3/session/$SESSION_ID/decision/ \
-H "x-api-key: $DIDIT_API_KEY"
\```

\## Where documents appear in the V3 decision

Inspect these plural arrays (every per-feature result is plural in V3):

\| Array | Contains |
\|---|---|
\| `id_verifications[]` | Government ID images, OCR fields, MRZ, expiry, issuing country |
\| `liveness_checks[]` | Selfie frames, passive liveness score |
\| `nfc_verifications[]` | NFC chip data, ICAO certificate chain |
\| `proof_of_address_checks[]` | POA document images, extracted address |

Image URLs are short-lived signed URLs — cache the bytes if you need them long-term, or re-fetch the decision when they expire.

\## Generate a PDF report

For a human-readable compliance export (used for SARs, audits, regulator requests):

\```bash
curl https://verification.didit.me/v3/session/$SESSION_ID/generate-pdf/ \
-H "x-api-key: $DIDIT_API_KEY" \
-o session-report.pdf
\```

The PDF includes session details, per-feature results, and embedded document images.

\## Re-verification / new document collection

To collect fresh documents (e.g. expired ID), create a new session for the same `vendor_data` — the new session attaches to the existing User entity:

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

\## Failure modes

\- `404` — wrong `session_id` or wrong `vendor_data` casing.
\- Expired signed image URL — re-fetch the decision to get fresh URLs.
\- `403` on PDF — your API key's role lacks PDF export permission.
\- Document monitoring is on by default and sends no warning before a document expires: when the ID's expiry date passes, the Approved session moves to "Kyc Expired" — see /core-technology/id-verification/document-monitoring-id-verification.

\## Response shape

See /reference/data-models for the full per-feature schema. Each plural-array item carries its own `status`, `document_images[]`, OCR extract, and decision metadata.

\## Sources of truth

\- /sessions-api/retrieve-session — decision schema
\- /reference/data-models — V3 plural-array contract
\- /core-technology/id-verification/overview — ID capture behaviour
\- /core-technology/proof-of-address/overview — POA capture
\- /integration/integration-prompt — canonical end-to-end prompt````

\</pre>



      
      

Вставьте в

Каждый документ, который пользователь загружает во время верификации, навсегда привязывается к его сущности User. На этой странице описано, какие данные собираются, как их получить и как загрузить дополнительные документы вручную.## Какие данные собирает Didit| Тип документа | Когда собирается | Извлекаемые поля |
| - | - | - |
| **Государственное удостоверение личности** (паспорт, национальное удостоверение, водительское удостоверение, вид на жительство) | Шаг [верификации личности](https://docs.didit.me/ru/core-technology/id-verification/overview.md) | Имя, дата рождения, номер документа, страна выдачи, срок действия, MRZ, если есть |
| **Селфи / кадры проверки живости** | Шаг [проверки живости](https://docs.didit.me/ru/core-technology/liveness/overview.md) | Наибольший кадр лица, оценка пассивной проверки живости |
| **Подтверждение адреса (POA)** | Шаг [POA](https://docs.didit.me/ru/core-technology/proof-of-address/overview.md) | Имя, адрес, эмитент, дата документа |
| **Считывание чипа NFC** | Шаг [NFC-верификации](https://docs.didit.me/ru/core-technology/nfc-verification/overview.md) | Данные чипа, цепочка сертификатов ICAO, сверка с OCR |
| **Дополнительные документы** | Запрос аналитика или шаги настраиваемого сценария | OCR, где применимо; в остальных случаях сохраняются без изменений |[Поддерживаемые типы документов](https://docs.didit.me/ru/core-technology/id-verification/supported-documents-id-verification.md) охватывают полную матрицу «страна × документ» (14,000+ документов в 220+ странах).## Получение документовДокументы связаны с **сессией**, в рамках которой они были собраны, а не напрямую с пользователем. Чтобы получить все документы пользователя:**1. Получите список сессий пользователя**```bash theme={null}
curl -G https://verification.didit.me/v3/sessions/ \
  -H "x-api-key: YOUR_API_KEY" \
  --data-urlencode "vendor_data=user-42"
```**2. Получите решение по каждой сессии**Решение по каждой сессии содержит URL-адреса собранных документов.```bash theme={null}
curl https://verification.didit.me/v3/session/{session_id}/decision/ \
  -H "x-api-key: YOUR_API_KEY"
```Проверьте поля `id_verification.document_images`, `proof_of_address.document_images` и `liveness.images` в ответе.**3. Используйте подписанные URL**URL изображений в ответе являются короткоживущими подписанными URL. Кэшируйте их на стороне клиента на время использования или повторно запрашивайте решение после истечения срока их действия.## Создание PDF-отчётаЧтобы получить удобочитаемый экспорт всех данных, собранных для сессии, включая все документы, используйте:**`GET /v3/session/{session_id}/generate-pdf/`**Возвращает PDF с деталями сессии, результатами функций и встроенными изображениями документов. Полезно для аудитов комплаенса, приложений к SAR и регуляторной отчётности.## Загрузка документов из консолиСотрудники комплаенса могут загружать дополнительные документы для пользователя или активной сессии:1. Перейдите в раздел *Users → \[user] → Documents → Upload document*.
2. Выберите тип документа (ID, POA, настраиваемый).
3. Загрузите файл; для поддерживаемых типов OCR запускается автоматически.
4. Документ прикрепляется к последней сессии (или вы можете создать сессию для устранения проблемы).> [!NOTE]
>
> Загрузка документов доступна только в консоли: публичного API endpoint для прикрепления документов напрямую к пользователю нет. Используйте сессии как точку входа для всех способов сбора документов.## Перекрёстная сверка документовКогда сессия собирает несколько типов документов, Didit выполняет их перекрёстную сверку:- **ID ↔ Liveness**: лицо на документе совпадает с селфи из проверки живости.
- **ID ↔ POA**: имя в POA совпадает с именем, извлечённым из удостоверения личности.
- **ID ↔ NFC**: MRZ или визуальные данные совпадают с данными чипа NFC.Несоответствия выводятся как предупреждения в решении по сессии и могут быть настроены на запуск ручной проверки.## Мониторинг документов и повторная верификацияДля сценариев, требующих постоянного контроля действительности документов (например, истёкших удостоверений):- **Срок действия документа** отслеживается для каждого верифицированного удостоверения личности. Запросите поле `expiration_date` в решении по сессии.
- **Мониторинг документов** включён по умолчанию и работает автоматически: ничего включать не нужно. Когда срок действия удостоверения истекает, сессия со статусом `"Approved"` переходит в `"Kyc Expired"`, в результат верификации личности добавляется предупреждение `DOCUMENT_EXPIRED`, и срабатывает webhook `status.updated`. До наступления даты предупреждение не отправляется.
- **Отключение** — установите **Expiration mode** в значение **Allow expired** для нужной страны и типа документа в [настройках верификации личности](https://docs.didit.me/ru/core-technology/id-verification/overview.md). **Reject expired**, режим по умолчанию, является тем режимом, при котором выполняется мониторинг. Документ, принятый в режиме **Allow expired**, никогда не отслеживается.
- **Повторная верификация** — создайте новую сессию с тем же `vendor_data`, чтобы обновить документы.## Геолокация документаПроверка [геолокации ID-документа](https://docs.didit.me/ru/core-technology/id-verification/document-geolocation-id-verification.md) сравнивает местоположение IP-адреса отправителя со страной выдачи удостоверения. Результаты прикрепляются к решению по сессии.## Конфиденциальность и хранение- Все документы шифруются при хранении.
- Доступ к изображениям осуществляется через короткоживущие подписанные URL.
- Хранение регулируется политикой [хранения данных](https://docs.didit.me/ru/console/data-retention.md) приложения.
- Пользователи имеют право запросить удаление; при удалении удаляются изображения, данные OCR и данные NFC.## Следующие шаги> [card] [Верификация личности](https://docs.didit.me/ru/core-technology/id-verification/overview.md)
>
> Как выполняются захват удостоверения личности и OCR.> [card] [Подтверждение адреса](https://docs.didit.me/ru/core-technology/proof-of-address/overview.md)
>
> Сбор документов POA.> [card] [Решение по сессии](https://docs.didit.me/ru/sessions-api/retrieve-session.md)
>
> Справочник по GET /v3/session/{id}/decision/.


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