Riwayat KYC Pengguna: Sesi & Verifikasi Ulang

Setiap sesi Verifikasi Pengguna (KYC) yang pernah dijalankan pengguna tetap terhubung secara permanen dengan entitas User pengguna tersebut. Anda dapat mengambil riwayat lengkap, memeriksa hasil setiap sesi, memicu verifikasi ulang, dan mengekspor laporan kepatuhan.

Mencantumkan semua sesi untuk seorang pengguna

Filter daftar Sesi menurut 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"

Respons menyertakan setiap sesi (apa pun statusnya): disetujui, ditolak, dalam peninjauan, ditinggalkan, atau kedaluwarsa.

Memahami agregat fitur

Peta features pada entitas User mencerminkan status terbaru dari setiap fitur di seluruh sesi:

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

Gunakan ini sebagai jalur cepat untuk menjawab pertanyaan “apakah pengguna sudah terverifikasi saat ini?”. Untuk catatan historis, yaitu semua sesi, semua fitur, dan semua hasil, tampilkan daftar sesi lalu periksa setiap keputusan.

Memeriksa satu sesi

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

Keputusan tersebut mencakup:

Hasil per fitur (ID, liveness, pencocokan wajah, AML, POA, NFC, dll.)
Data dan gambar dokumen yang diekstrak (URL bertanda tangan)
Temuan AML beserta skor kecocokan dan skor risiko
Analisis Perangkat & IP dan konteks perangkat
Catatan peninjau dan tindakan manual

Lihat ambil sesi untuk skema lengkapnya.

Memicu verifikasi ulang

Jika Anda perlu meminta pengguna untuk memverifikasi ulang (misalnya KYC ulang tahunan, dokumen yang kedaluwarsa, atau pemeriksaan ulang berbasis pemicu):

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"
  }'

Sesi baru akan terhubung dengan entitas User yang sama. Setelah selesai, peta features pada entitas akan diperbarui dengan hasil yang baru.

Kirim ulang atau sesi baru

Skenario	Gunakan
Sesi pengguna ditolak karena masalah yang dapat diperbaiki (ID buram, pencahayaan buruk)	Kirim ulang: sesi yang sama, unggahan baru
Verifikasi ulang penuh atau KYC ulang berkala	Buat sesi baru
Remediasi yang dipicu oleh aturan transaksi	Transaksi otomatis membuat sesi remediasi (status `AWAITING_USER`)

Mengekspor laporan kepatuhan

Untuk audit, SAR, atau permintaan regulator, buat PDF untuk sesi mana pun:

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

Untuk mencakup seluruh riwayat pengguna dalam satu berkas, unduh PDF riwayat pengguna: halaman sampul (ringkasan profil, status fitur, indeks sesi) diikuti laporan lengkap untuk setiap sesi yang dapat dilaporkan, dimulai dari sesi yang paling lama, dengan batas 20 sesi terbaru.

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

Dokumen ini sama dengan yang dihasilkan konsol dari Users → [user] → Actions → Download PDF. Untuk ekspor CSV massal dari banyak pengguna, gunakan ekspor tingkat aplikasi di Review & Operations → Export PDF/CSV.

Membagikan sesi kepada pihak ketiga

Jika Anda perlu membagikan verifikasi pengguna kepada aplikasi mitra (misalnya skenario KYC yang dapat digunakan kembali), gunakan:

POST /v3/session/{session_id}/share/: membuat token yang dapat dibagikan.
POST /v3/session/import-shared/: mengimpor sesi yang dibagikan di sisi penerima.

Lihat KYC yang dapat digunakan kembali untuk pola lengkapnya.

Alur kerja berbasis riwayat

Gunakan riwayat sesi untuk mendukung keputusan kepatuhan yang lebih cerdas:

Lewati langkah jika pengguna sudah memiliki liveness yang disetujui dalam N hari terakhir.
Wajibkan pemeriksaan tambahan jika sesi terbaru pengguna ditolak.
Tandai ketika jumlah sesi pengguna meningkat secara tidak terduga.
Pantau pemindaian ulang AML berkelanjutan melalui fitur pemantauan berkelanjutan.

Langkah selanjutnya

Model data

Cara penghitungan peta fitur dan penghitung.

Ambil sesi

Skema keputusan sesi lengkap.

KYC yang dapat digunakan kembali

Gunakan kembali data terverifikasi di berbagai aplikasi.

Ikhtisar

Harga

Alur Kerja & Verifikasi

Peninjauan & Operasional

Entitas (Pengguna & Bisnis)

Pengaturan & Kustomisasi

Keamanan & Kepatuhan

Didit Academy

Sumber Daya

Riwayat KYC Pengguna: Sesi & Verifikasi Ulang

Mencantumkan semua sesi untuk seorang pengguna

Memahami agregat fitur

Memeriksa satu sesi

Memicu verifikasi ulang

Kirim ulang atau sesi baru

Mengekspor laporan kepatuhan

Membagikan sesi kepada pihak ketiga

Alur kerja berbasis riwayat

Langkah selanjutnya

Model data

Ambil sesi

KYC yang dapat digunakan kembali

​Mencantumkan semua sesi untuk seorang pengguna

​Memahami agregat fitur

​Memeriksa satu sesi

​Memicu verifikasi ulang

​Kirim ulang atau sesi baru

​Mengekspor laporan kepatuhan

​Membagikan sesi kepada pihak ketiga

​Alur kerja berbasis riwayat

​Langkah selanjutnya

Model data

Ambil sesi

KYC yang dapat digunakan kembali

Mencantumkan semua sesi untuk seorang pengguna

Memahami agregat fitur

Memeriksa satu sesi

Memicu verifikasi ulang

Kirim ulang atau sesi baru

Mengekspor laporan kepatuhan

Membagikan sesi kepada pihak ketiga

Alur kerja berbasis riwayat

Langkah selanjutnya