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

# Entitas Pengguna & Bisnis: Model Identitas Didit

> Pengguna dan Bisnis adalah dua entitas utama Didit. Keduanya menggabungkan sesi KYC, transaksi, dokumen, biometrik, dan risiko dalam satu profil.

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:

**1. 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.

```bash theme={null}
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.

**2. 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.

```bash theme={null}
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" }'
```

**3. 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.

```mermaid theme={null}
flowchart LR
    VD["vendor_data:<br/>user-42"] --> U[User entity]
    S1[User Verification (KYC) session #1] --> VD
    S2[User Verification (KYC) session #2] --> VD
    T1[Transaction #1] --> VD
    T2[Transaction #2] --> VD
    F[Face biometric] --> VD
    D[Documents] --> VD
    BL[Blocklist entry] --> VD
```

Pelajari selengkapnya di [panduan penautan `vendor_data`](https://docs.didit.me/id/entities/vendor-data-linking).

## 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](https://docs.didit.me/id/entities/users/overview.md) dan [Bisnis](https://docs.didit.me/id/entities/businesses/overview.md).

## 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](https://docs.didit.me/id/business-verification/key-people.md).

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](https://docs.didit.me/id/entities/lifecycle.md) lengkap untuk transisi dan event webhook.

## Langkah selanjutnya

> [card] [Siklus hidup](https://docs.didit.me/id/entities/lifecycle.md)
>
> Status, transisi, dan peristiwa siklus hidup untuk setiap entitas.

> [card] [Penautan vendor data](https://docs.didit.me/id/entities/vendor-data-linking.md)
>
> Cara `vendor_data` mengaitkan sesi, transaksi, dan entitas.

> [card] [Pengguna](https://docs.didit.me/id/entities/users/overview.md)
>
> Pembahasan mendalam tentang entitas Pengguna, operasi, dan alur kerja di konsol.

> [card] [Bisnis](https://docs.didit.me/id/entities/businesses/overview.md)
>
> Pembahasan mendalam tentang entitas Bisnis, operasi, dan alur kerja di konsol.

> [card] [Webhook entitas](https://docs.didit.me/id/entities/webhooks.md)
>
> Peristiwa waktu nyata untuk setiap perubahan entitas.

> [card] [Daftar blokir](https://docs.didit.me/id/console/blocklist-users.md)
>
> Cara entri daftar blokir berinteraksi dengan entitas Pengguna dan Bisnis.


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