Langsung ke konten utama
Setiap entitas Pengguna dan Bisnis di Didit melewati siklus hidup yang dapat diprediksi. Memahami siklus hidup ini adalah kunci untuk merancang alur onboarding, pemantauan berkelanjutan, dan alur remediasi Anda.

​
Diagram siklus hidup

​
Status secara rinci

Mengubah status melalui PATCH /v3/users/{vendor_data}/update-status/ atau PATCH /v3/businesses/{vendor_data}/update-status/ mengirim webhook (user.status.updated / business.status.updated) agar sistem hilir dapat bereaksi secara waktu nyata.

​
Tahapan siklus hidup

Pembuatan

Entitas dibuat dengan salah satu dari tiga cara:
  • Dibuat otomatis saat Anda memulai sesi dengan vendor_data baru. Entitas dibuat dengan status ACTIVE.
  • Dibuat sebelumnya melalui API menggunakan POST /v3/users/create/ atau POST /v3/businesses/create/. Statusnya secara bawaan adalah ACTIVE.
  • Dibuat di konsol oleh operator kepatuhan. Status awalnya ACTIVE kecuali operator menentukan lain.
Setiap entitas memperoleh uuid yang dibuat oleh Didit dan pengenal vendor_data yang dimiliki oleh pelanggan.

Verifikasi

Sesi dilekatkan ke entitas melalui vendor_data. Setiap sesi dijalankan melalui alur kerja yang Anda konfigurasi: verifikasi identitas, liveness, pencocokan wajah, AML, dokumen, pencarian registri untuk KYB, dan seterusnya.Sesi yang selesai memperbarui penghitung agregat entitas:
  • session_count, approved_count, declined_count, in_review_count
  • Peta features: status terbaru setiap fitur di seluruh sesi (misalnya { "id_verification": "APPROVED", "aml": "IN_REVIEW" })
  • Kolom profil diperbarui berdasarkan sesi terbaru yang disetujui (misalnya full_name, date_of_birth, portrait_image).

Penggunaan aktif

Setelah entitas memiliki satu atau lebih sesi yang disetujui, Anda dapat:
  • Mengirim transaksi yang merujuk entitas melalui vendor_data dalam payload transaksi
  • Menjalankan pemantauan AML berkelanjutan: pemindaian ulang berkala terhadap daftar sanksi / PEP / media negatif
  • Melakukan verifikasi ulang sesuai jadwal: membuat sesi baru untuk vendor_data yang sama pada interval rutin
  • Mengagregasi sinyal risiko di seluruh sesi dan transaksi

Perubahan status

Perubahan status entitas terjadi secara otomatis atau manual.Perubahan otomatis
  • ACTIVE → FLAGGED saat transaksi melampaui ambang batas peninjauan atau saat aturan menambahkan entitas ke daftar pantauan.
  • ACTIVE → BLOCKED saat biometrik wajah cocok dengan entri daftar blokir.
Sesi yang ditolak tidak memasukkan entitas ke daftar blokir, sehingga status tidak berubah. Memasukkan subjek yang ditolak ke daftar blokir adalah langkah manual: tambahkan entri dari halaman Daftar Blokir atau Lists API, dan entri USER (vendor_data) akan mengatur status menjadi BLOCKED.Perubahan manual terjadi saat analis mengubah status dari konsol atau saat Anda memanggil endpoint update-status.Setiap perubahan status mengirim webhook user.status.updated atau business.status.updated.

Penghapusan

Entitas dihapus melalui POST /v3/users/delete/ atau POST /v3/businesses/delete/ (batch). Rekaman entitas dihapus secara permanen. Menghapus Pengguna juga menghapus setiap templat biometrik yang masih tersimpan setelah sesi dihapus, sehingga orang tersebut tidak lagi cocok dalam deteksi duplikat dan Pencarian Wajah.Sesi verifikasi tidak tercakup oleh endpoint ini, begitu pula transaksi. Hapus sesi dengan Hapus Sesi atau Hapus Sesi Batch; transaksi dihapus dari Konsol.

​
Stempel waktu aktivitas

Entitas melacak aktivitas untuk membantu Anda mengidentifikasi profil yang sudah usang atau aktif: Gunakan stempel waktu ini untuk memfilter entitas yang tidak aktif, menjadwalkan verifikasi ulang, atau memicu pemantauan berkelanjutan.

​
Peristiwa yang dikirim selama siklus hidup

Lihat webhook entitas untuk bentuk payload dan semantik pengiriman.

​
Langkah selanjutnya

Penautan data vendor

Cara vendor_data menghubungkan sesi, transaksi, dan entitas.

Operasi Pengguna

Membuat, memperbarui, mengubah status, dan menghapus entitas Pengguna.

Operasi Bisnis

Membuat, memperbarui, mengubah status, dan menghapus entitas Bisnis.
Terakhir diubah pada 7 November 2026