Entitas Pengguna & Bisnis: Model Identitas Didit

Didit mengatur semua yang terjadi di aplikasi Anda berdasarkan dua jenis entitas utama:

Entitas	Mewakili	Terhubung ke
Pengguna	Orang perseorangan	Sesi Verifikasi Pengguna (KYC), biometrik wajah, transaksi (sebagai pemohon/pihak lawan), daftar blokir
Bisnis	Badan hukum (perusahaan, LLC, usaha perseorangan, dana)	Sesi Verifikasi Bisnis (KYB), pejabat, UBO, transaksi (sebagai pemohon/pihak lawan), daftar blokir

Setiap sesi verifikasi, setiap transaksi, dan setiap entri daftar blokir dapat dikaitkan dengan sebuah entitas. Setelah dikaitkan, entitas menjadi profil permanen yang menghimpun riwayat, sinyal risiko, dan status kepatuhan dari waktu ke waktu.

Entitas vs sesi

Sebuah entitas dan sebuah sesi adalah dua hal yang berbeda.

Konsep	Cakupan	Masa berlaku	Contoh
Sesi	Satu peristiwa verifikasi	Satu alur (dari hitungan menit hingga beberapa hari saat dalam peninjauan)	Satu percobaan KYC
Entitas	Profil permanen	Berlaku selama pengguna/bisnis ada di platform Anda	Pelanggan “Jane Doe” dengan 3 sesi Verifikasi Pengguna (KYC) selama 2 tahun

Satu entitas dapat memiliki banyak sesi, misalnya verifikasi ulang, pengajuan ulang, pemeriksaan tambahan, dan pemantauan berkelanjutan secara berkala. Entitas menghimpun hasilnya.

Pembuatan otomatis vs pembuatan manual di awal

Entitas dibuat dengan salah satu dari tiga cara berikut:

Dibuat otomatis dari sesi

Saat Anda membuat sesi dengan pengenal vendor_data dan belum ada entitas yang cocok, Didit membuat entitas tersebut secara otomatis. Ini adalah jalur yang paling umum.

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

Entitas Pengguna untuk user-42 dibuat tepat saat sesi dimulai.

Dibuat terlebih dahulu melalui Management API

Buat entitas terlebih dahulu, lalu mulai sesi terhadapnya. Berguna jika Anda ingin menyiapkan sinyal risiko (status, tag, metadata kustom) sebelum verifikasi pertama.

curl -X POST https://verification.didit.me/v3/users/create/ \
  -H "x-api-key: YOUR_API_KEY" \
  -d '{ "vendor_data": "user-42", "display_name": "Jane Doe" }'

Dibuat di konsol

Tim kepatuhan Anda dapat membuat pengguna atau bisnis langsung dari Business Console, berguna untuk onboarding manual, impor, atau alur remediasi.

Cara entitas menautkan semuanya

Kolom vendor_data adalah kunci penautan. Saat Anda meneruskan vendor_data pada sesi atau transaksi apa pun, Didit mengarahkannya ke entitas yang cocok. Pelajari selengkapnya di panduan penautan vendor_data.

Yang dapat Anda lakukan dengan entitas

Untuk setiap entitas Pengguna atau Bisnis, Anda dapat:

Operasi	Tujuan
Buat / perbarui	Atur atau ubah data profil entitas (nama, negara, metadata kustom)
Ubah status	Tandai sebagai `ACTIVE`, `FLAGGED`, atau `BLOCKED`. Penegakan berlaku untuk sesi dan transaksi berikutnya
Lampirkan biometrik	Unggah referensi wajah untuk pencarian 1:N, deteksi duplikat, atau penambahan ke daftar blokir
Tinjau riwayat KYC/KYB	Ambil semua sesi yang terkait dengan entitas, beserta hasil per fitur
Tinjau riwayat transaksi	Ambil setiap transaksi yang entitasnya berperan sebagai pemohon atau pihak lawan
Tambahkan ke daftar blokir	Blokir sesi atau transaksi berikutnya yang melibatkan entitas ini
Impor / ekspor	Unggah entitas secara massal dari CSV atau ekspor untuk alat kepatuhan eksternal
Hapus	Hapus entitas (riwayat tetap disimpan untuk audit)

Panduan rinci tersedia di Pengguna dan Bisnis.

Relasi Pengguna ↔ Bisnis

Satu Pengguna dapat ditautkan ke satu atau banyak Bisnis. Hal ini terjadi secara alami selama KYB:

Seorang Pengguna dapat menjadi direktur di satu Bisnis dan UBO di Bisnis lain.
Sesi Verifikasi Pengguna (KYC) milik seorang Pengguna dapat ditautkan ke sesi Verifikasi Bisnis (KYB) suatu Bisnis melalui alur Pihak Kunci.

Didit mempertahankan relasi ini. Saat Anda memeriksa entitas Bisnis, Anda dapat melihat setiap Pengguna yang tertaut, dan saat Anda memeriksa entitas Pengguna, Anda dapat melihat setiap Bisnis yang terkait dengannya.

Siklus hidup dan status

Setiap entitas memiliki status yang menentukan apakah Didit menerapkan pemblokiran pada aktivitas baru:

Status	Efek
`ACTIVE`	Normal. Sesi dan transaksi berjalan sesuai konfigurasi alur kerja dan aturan
`FLAGGED`	Sesi dan transaksi diizinkan, tetapi otomatis diarahkan ke peninjauan manual
`BLOCKED`	Sesi dan transaksi otomatis ditolak, dan tidak ada sesi baru yang dapat dibuat

Lihat siklus hidup entitas lengkap untuk transisi dan event webhook.

Langkah selanjutnya

Siklus hidup

Status, transisi, dan peristiwa siklus hidup untuk setiap entitas.

Penautan vendor data

Cara vendor_data mengaitkan sesi, transaksi, dan entitas.

Pengguna

Pembahasan mendalam tentang entitas Pengguna, operasi, dan alur kerja di konsol.

Bisnis

Pembahasan mendalam tentang entitas Bisnis, operasi, dan alur kerja di konsol.

Webhook entitas

Peristiwa waktu nyata untuk setiap perubahan entitas.

Daftar blokir

Cara entri daftar blokir berinteraksi dengan entitas Pengguna dan Bisnis.

Ikhtisar

Harga

Alur Kerja & Verifikasi

Peninjauan & Operasional