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

# Dokumen Pengguna: Identitas, POA, File Pendukung

> Identitas, bukti alamat, dan file pendukung pada entitas pengguna Didit: apa yang dikumpulkan, cara mengambilnya, dan cara mengunggah dari konsol.



Prompt Dokumen Pengguna
        Salin prompt ke papan klip



      
      

\<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>



      
      

Tempel ke

Setiap dokumen yang diunggah pengguna selama verifikasi ditautkan secara permanen ke entitas User mereka. Halaman ini menjelaskan apa saja yang dikumpulkan, cara mengambilnya, dan cara mengunggah dokumen tambahan secara manual.## Apa yang dikumpulkan Didit| Jenis dokumen | Waktu pengumpulan | Kolom yang diekstrak |
| - | - | - |
| **ID pemerintah** (paspor, ID nasional, SIM, izin tinggal) | Langkah [verifikasi identitas](https://docs.didit.me/id/core-technology/id-verification/overview.md) | Nama, tanggal lahir, nomor dokumen, negara penerbit, tanggal kedaluwarsa, MRZ jika tersedia |
| **Swafoto / bingkai liveness** | Langkah [deteksi liveness](https://docs.didit.me/id/core-technology/liveness/overview.md) | Potongan wajah terbesar, skor liveness pasif |
| **Bukti alamat (POA)** | Langkah [POA](https://docs.didit.me/id/core-technology/proof-of-address/overview.md) | Nama, alamat, penerbit, tanggal dokumen |
| **Pembacaan chip NFC** | Langkah [verifikasi NFC](https://docs.didit.me/id/core-technology/nfc-verification/overview.md) | Data chip, rantai sertifikat ICAO, kecocokan dengan OCR |
| **Dokumen tambahan** | Permintaan analis atau langkah alur kerja kustom | OCR jika berlaku, selain itu disimpan apa adanya |[Jenis dokumen yang didukung](https://docs.didit.me/id/core-technology/id-verification/supported-documents-id-verification.md) mencakup seluruh matriks negara × dokumen (14,000+ dokumen di 220+ negara).## Mengambil dokumenDokumen dikaitkan dengan **sesi** yang mengumpulkannya, bukan langsung dengan pengguna. Untuk mencantumkan semua dokumen seorang pengguna:**1. Daftar sesi pengguna**```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. Ambil keputusan dari setiap sesi**Setiap keputusan sesi menyertakan URL ke dokumen yang dikumpulkan.```bash theme={null}
curl https://verification.didit.me/v3/session/{session_id}/decision/ \
  -H "x-api-key: YOUR_API_KEY"
```Periksa kolom `id_verification.document_images`, `proof_of_address.document_images`, dan `liveness.images` dalam respons.**3. Gunakan URL bertanda tangan**URL gambar dalam respons adalah URL bertanda tangan yang berumur pendek. Simpan dalam cache di sisi klien selama digunakan, atau ambil ulang keputusan saat URL kedaluwarsa.## Membuat laporan PDFUntuk ekspor yang mudah dibaca dari semua yang dikumpulkan untuk sebuah sesi, termasuk seluruh dokumen, gunakan:**`GET /v3/session/{session_id}/generate-pdf/`**Mengembalikan PDF berisi detail sesi, hasil fitur, dan gambar dokumen yang disematkan. Berguna untuk audit kepatuhan, lampiran SAR, dan pengajuan kepada regulator.## Mengunggah dokumen dari konsolPetugas kepatuhan dapat mengunggah dokumen tambahan untuk seorang pengguna atau sesi aktif:1. Buka *Users → \[pengguna] → Documents → Upload document*.
2. Pilih jenis dokumen (ID, POA, kustom).
3. Unggah berkas; OCR berjalan otomatis untuk jenis yang didukung.
4. Dokumen dilampirkan ke sesi terbaru (atau Anda dapat membuat sesi remediasi).> [!NOTE]
>
> Antarmuka unggah dokumen hanya tersedia di konsol: tidak ada endpoint API publik untuk melampirkan dokumen langsung ke pengguna. Gunakan sesi sebagai titik awal untuk semua pengumpulan dokumen.## Referensi silang dokumenKetika sebuah sesi mengumpulkan beberapa jenis dokumen, Didit melakukan referensi silang:- **ID ↔ Liveness**: wajah pada ID cocok dengan swafoto liveness.
- **ID ↔ POA**: nama pada POA cocok dengan nama yang diekstrak dari ID.
- **ID ↔ NFC**: MRZ / data visual cocok dengan data chip NFC.Ketidaksesuaian ditampilkan sebagai peringatan pada keputusan sesi dan dapat dikonfigurasi untuk memicu peninjauan manual.## Pemantauan dokumen dan verifikasi ulangUntuk kasus penggunaan yang membutuhkan validitas dokumen yang perlu dipantau secara berkelanjutan (misalnya ID yang kedaluwarsa):- **Kedaluwarsa dokumen** dilacak pada setiap ID yang terverifikasi. Ambil keputusan sesi untuk kolom `expiration_date`.
- **Pemantauan dokumen**: aktif secara default dan otomatis, sehingga tidak ada yang perlu diaktifkan. Ketika tanggal kedaluwarsa ID terlewati, sesi `"Approved"` berpindah ke `"Kyc Expired"`, hasil verifikasi ID mendapat peringatan `DOCUMENT_EXPIRED`, dan webhook `status.updated` dikirim. Tidak ada peringatan yang dikirim sebelum tanggal tersebut terlewati.
- **Menonaktifkannya**: atur **Expiration mode** ke **Allow expired** untuk negara dan jenis dokumen tersebut di [pengaturan verifikasi ID](https://docs.didit.me/id/core-technology/id-verification/overview.md). **Reject expired**, yang merupakan default, adalah mode yang memantau. Dokumen yang diterima dengan **Allow expired** tidak pernah dipantau.
- **Verifikasi ulang**: picu sesi baru dengan `vendor_data` yang sama untuk menyegarkan dokumen.## Geolokasi dokumen[Pengecekan geolokasi dokumen ID](https://docs.didit.me/id/core-technology/id-verification/document-geolocation-id-verification.md) membandingkan lokasi IP pengirim dengan negara penerbit ID. Hasilnya dilampirkan pada keputusan sesi.## Privasi dan retensi- Semua dokumen dienkripsi saat disimpan.
- Akses gambar melalui URL bertanda tangan yang berumur pendek.
- Retensi mengikuti kebijakan [retensi data](https://docs.didit.me/id/console/data-retention.md) aplikasi.
- Pengguna berhak meminta penghapusan; penghapusan menghapus gambar, hasil ekstraksi OCR, dan data NFC.## Langkah selanjutnya> [card] [Verifikasi identitas](https://docs.didit.me/id/core-technology/id-verification/overview.md)
>
> Cara kerja pengambilan ID dan OCR.> [card] [Bukti alamat](https://docs.didit.me/id/core-technology/proof-of-address/overview.md)
>
> Pengumpulan dokumen POA.> [card] [Keputusan sesi](https://docs.didit.me/id/sessions-api/retrieve-session.md)
>
> Referensi GET /v3/session/{id}/decision/.


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