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

# Pengguna Vendor: Catatan KYC Persisten

> Pengguna Vendor adalah catatan identitas persisten Didit: riwayat KYC, biometrik, dokumen, transaksi, dan status daftar blokir dalam satu profil.

**Entitas Pengguna** merepresentasikan satu individu (pelanggan, pengguna akhir, atau pemohon Anda) di seluruh interaksi verifikasi, transaksi, dan kepatuhan yang mereka lakukan di platform Anda di Didit.

Setelah Pengguna ada, semua aktivitas yang terkait dengan `vendor_data` yang sama masuk ke profil yang sama. Anda mendapatkan satu tampilan terpadu untuk identitas, risiko, dan kepatuhan setiap orang.

## Apa yang tersimpan pada Pengguna

| Kategori | Kolom / objek |
| - | - |
| **Identitas** | `vendor_data`, `uuid`, `display_name`, `full_name`, `date_of_birth`, `portrait_image` |
| **Status** | `ACTIVE`, `FLAGGED`, `BLOCKED` |
| **Agregat sesi** | `session_count`, `approved_count`, `declined_count`, `in_review_count`, peta `features` |
| **Kontak terverifikasi** | `approved_emails[]`, `approved_phones[]` |
| **Geografi** | `issuing_states[]` (dari dokumen identitas yang terverifikasi) |
| **Aktivitas** | `first_session_at`, `last_session_at`, `last_activity_at` |
| **Biometrik** | Rekaman wajah yang dilampirkan (untuk pencarian / deteksi duplikat / daftar blokir) |
| **Dokumen** | Dokumen identitas, bukti alamat, dan swafoto dari sesi |
| **Relasi** | Entitas Bisnis yang terhubung (jika Pengguna adalah direktur / UBO dari bisnis yang diverifikasi di aplikasi Anda) |
| **Metadata** | JSON arbitrer untuk data Anda sendiri |

Lihat [model data Pengguna](https://docs.didit.me/id/entities/users/data-model.md) lengkap untuk tipe, indeks, dan kasus khusus.

## Kapan Pengguna dibuat

**1. Otomatis: pada sesi pertama dengan vendor\_data baru**

Kasus yang umum terjadi. Anda memanggil `POST /v3/session/` dengan nilai `vendor_data` yang belum pernah dilihat Didit. Entitas Pengguna dibuat dengan status `ACTIVE` dan ditautkan ke sesi tersebut.

**2. Secara eksplisit: melalui POST /v3/users/create/**

Anda membuat Pengguna terlebih dahulu sebelum sesi apa pun berjalan. Berguna untuk mengisi metadata awal, menetapkan status awal, atau melakukan onboarding pelanggan secara massal dari database yang sudah ada.

**3. Dari konsol**

Petugas kepatuhan membuat Pengguna dari halaman Users, misalnya saat melakukan onboarding pelanggan yang diverifikasi secara manual.

## Yang dapat Anda lakukan

| Operasi | Cara |
| - | - |
| [Daftar pengguna](https://docs.didit.me/id/entities/users/operations.md#daftar-pengguna) | `GET /v3/users/` dengan filter (status, tanggal, negara) |
| [Ambil pengguna](https://docs.didit.me/id/entities/users/operations.md#ambil-satu-pengguna) | `GET /v3/users/{vendor_data}/` |
| [Buat pengguna](https://docs.didit.me/id/entities/users/operations.md#buat-pengguna) | `POST /v3/users/create/` |
| [Perbarui profil](https://docs.didit.me/id/entities/users/operations.md#perbarui-pengguna) | `PATCH /v3/users/{vendor_data}/` |
| [Ubah status](https://docs.didit.me/id/entities/users/operations.md#ubah-status) | `PATCH /v3/users/{vendor_data}/update-status/` |
| [Hapus pengguna](https://docs.didit.me/id/entities/users/operations.md#hapus-pengguna-massal) | `POST /v3/users/delete/` (batch) |
| [Lampirkan / cari wajah](https://docs.didit.me/id/entities/users/faces-and-biometrics.md) | Konsol + Lists API untuk daftar blokir |
| [Lihat dokumen](https://docs.didit.me/id/entities/users/documents.md) | Melalui keputusan sesi |
| [Tambahkan ke daftar blokir](https://docs.didit.me/id/entities/users/blocklist.md) | Konsol + Lists API |
| [Tinjau riwayat KYC](https://docs.didit.me/id/entities/users/kyc-history.md) | `GET /v3/sessions?vendor_data=...` |
| [Tinjau transaksi](https://docs.didit.me/id/entities/users/transactions.md) | `GET /v3/transactions/?vendor_data=...` |
| [Impor / ekspor](https://docs.didit.me/id/entities/users/import-export.md) | Hanya konsol (CSV) |
| [Kelola di konsol](https://docs.didit.me/id/entities/users/console.md) | Panduan lengkap UI |

## Pengguna dan Bisnis

Satu Pengguna dapat terhubung ke satu atau beberapa Bisnis, misalnya ketika orang yang sama menjadi direktur satu perusahaan dan UBO perusahaan lain. Didit mempertahankan tautan ini secara otomatis ketika [KYB](https://docs.didit.me/id/business-verification/overview.md) mengidentifikasi orang dari registri perusahaan.

## Hubungan Pengguna ↔ sesi

```mermaid theme={null}
flowchart LR
    U[User entity<br/>vendor_data = user-42]
    S1["User Verification (KYC) session #1<br/>(approved 2025-01)"]
    S2["User Verification (KYC) session #2<br/>(resubmit, in review)"]
    S3["User Verification (KYC) session #3<br/>(re-verification 2026-01)"]
    S1 --> U
    S2 --> U
    S3 --> U
```

Pengguna mengagregasi status **terbaru** dari setiap fitur di semua sesi. Pemeriksaan `aml` yang gagal pada sesi terbaru akan muncul di kolom `features.aml` milik Pengguna, meskipun sesi yang lebih lama disetujui.

## Langkah selanjutnya

> [card] [Model data](https://docs.didit.me/id/entities/users/data-model.md)
>
> Setiap kolom, tipe, dan indeks.

> [card] [Operasi](https://docs.didit.me/id/entities/users/operations.md)
>
> Buat, perbarui, ubah status, hapus.

> [card] [Wajah & biometrik](https://docs.didit.me/id/entities/users/faces-and-biometrics.md)
>
> Lampirkan wajah untuk pencarian dan penambahan ke daftar blokir.

> [card] [Daftar blokir](https://docs.didit.me/id/entities/users/blocklist.md)
>
> Cara kerja daftar blokir untuk pengguna.

> [card] [Riwayat KYC](https://docs.didit.me/id/entities/users/kyc-history.md)
>
> Setiap sesi yang terkait dengan pengguna.

> [card] [Konsol](https://docs.didit.me/id/entities/users/console.md)
>
> Panduan lengkap UI Pengguna.


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