Model Data Pengguna: Skema Pengguna Vendor

Halaman ini mendokumentasikan setiap kolom pada entitas User. Kolom dikelompokkan ke dalam lima grup: identitas, status, agregat sesi, stempel waktu aktivitas, dan metadata.

Kolom identitas

Kolom	Tipe	Deskripsi
`uuid`	UUID	Kunci utama yang ditetapkan Didit. Stabil dan unik.
`didit_internal_id`	string	Pengenal internal yang mudah dibaca (ditampilkan dalam respons API).
`vendor_data`	string	Pengenal Anda untuk pengguna. Unik per aplikasi. Baca selengkapnya.
`display_name`	string	Nama pengganti yang ditampilkan di konsol. Menggunakan `full_name` atau `vendor_data` jika tidak diisi.
`full_name`	string	Nama lengkap resmi yang diambil dari dokumen identitas pada sesi Verifikasi Pengguna (KYC) terbaru yang disetujui.
`date_of_birth`	date (ISO 8601)	Diambil dari sesi Verifikasi Pengguna (KYC) terbaru yang disetujui.
`portrait_image`	URL	URL S3 bertanda tangan untuk swafoto dari pemeriksaan liveness terbaru yang disetujui.

full_name, date_of_birth, dan portrait_image hanya dapat dibaca jika berasal dari sesi yang telah diverifikasi. Anda dapat menggantinya melalui konsol atau melalui PATCH /v3/users/{vendor_data}/, tetapi penggantian manual akan ditandai di log audit.

Status

Kolom	Tipe	Nilai	Deskripsi
`status`	enum	`ACTIVE`, `FLAGGED`, `BLOCKED`	Mengatur penegakan untuk sesi dan transaksi mendatang. Lihat siklus hidup.

Kolom agregat sesi

Kolom-kolom ini dihitung oleh Didit dan diperbarui secara waktu nyata saat sesi selesai.

Kolom	Tipe	Deskripsi
`session_count`	int	Total sesi yang pernah dibuat untuk pengguna ini
`approved_count`	int	Sesi yang selesai dengan `APPROVED`
`declined_count`	int	Sesi yang selesai dengan `DECLINED`
`in_review_count`	int	Sesi yang saat ini `IN_REVIEW`
`issuing_states[]`	array kode negara ISO	Negara dari semua dokumen identitas yang diverifikasi di seluruh sesi
`approved_emails[]`	array string	Email yang diverifikasi melalui Verifikasi Email
`approved_phones[]`	array string	Nomor telepon yang diverifikasi melalui Verifikasi Telepon
`features`	objek	Status terbaru dari setiap fitur di seluruh sesi

Peta `features`

Setiap sesi menjalankan satu atau beberapa fitur (verifikasi identitas, liveness, pencocokan wajah, AML, POA, NFC, dan lainnya). Peta features menyimpan status terbaru dari setiap fitur untuk pengguna ini:

{
  "id_verification": "APPROVED",
  "liveness": "APPROVED",
  "face_match": "APPROVED",
  "aml": "IN_REVIEW",
  "proof_of_address": "APPROVED",
  "nfc_verification": "NOT_FINISHED"
}

Status fitur: NOT_FINISHED, APPROVED, DECLINED, IN_REVIEW, EXPIRED, ABANDONED, RESUB_REQUESTED. Gunakan peta features sebagai jalur cepat untuk memastikan apakah pengguna ini sudah sepenuhnya terverifikasi saat ini tanpa harus memeriksa semua sesi satu per satu.

Stempel waktu aktivitas

Kolom	Tipe	Diperbarui saat
`first_session_at`	stempel waktu ISO	Sesi pertama dibuat
`last_session_at`	stempel waktu ISO	Sesi terbaru dibuat atau diperbarui
`last_activity_at`	stempel waktu ISO	Ada perubahan apa pun: sesi, transaksi, status, profil, catatan, tag
`created_at`	stempel waktu ISO	Baris entitas dibuat
`updated_at`	stempel waktu ISO	Baris entitas terakhir diperbarui

Metadata

Kolom	Tipe	Deskripsi
`metadata`	objek (JSON)	JSON bebas yang Anda kendalikan. Gunakan untuk tag internal, tingkat, sumber pendaftaran, dan sebagainya.
`tags[]`	array	Tag yang dikelola melalui konsol atau API, untuk pemfilteran dan pengelompokan

Metadata tidak memiliki skema: Didit menyimpan apa pun yang Anda tulis.

Relasi (tidak disimpan di baris pengguna)

Relasi	Cara mengaksesnya
Sesi	`GET /v3/sessions?vendor_data=<value>`
Transaksi (sebagai pemohon)	`GET /v3/transactions/?vendor_data=<value>`
Transaksi (sebagai pihak lawan)	Filter daftar transaksi berdasarkan vendor_data pihak lawan di konsol
Bisnis terkait (direktur / UBO)	Ditampilkan di halaman detail pengguna di konsol
Biometrik wajah	Konsol dan Lists API
Entri daftar blokir	Lists API: filter entri menggunakan pengenal pengguna

Contoh respons

{
  "uuid": "9c7d2a30-2f98-4d4f-9d2d-1a7c4b1e5b6a",
  "didit_internal_id": "U-2026-00042",
  "vendor_data": "user-42",
  "display_name": "Jane Doe",
  "full_name": "John Doe",
  "date_of_birth": "1990-01-01",
  "portrait_image": "https://<media-host>/...",
  "status": "ACTIVE",
  "session_count": 3,
  "approved_count": 2,
  "declined_count": 0,
  "in_review_count": 1,
  "issuing_states": ["US", "ES"],
  "approved_emails": ["jane@example.com"],
  "approved_phones": ["+14155550123"],
  "features": {
    "id_verification": "APPROVED",
    "liveness": "APPROVED",
    "face_match": "APPROVED",
    "aml": "IN_REVIEW"
  },
  "first_session_at": "2025-03-01T12:00:00Z",
  "last_session_at": "2026-04-10T09:00:00Z",
  "last_activity_at": "2026-04-16T10:00:00Z",
  "metadata": { "tier": "premium" }
}

Langkah selanjutnya

Operasi

Buat, perbarui, ubah status, hapus.

Riwayat KYC

Ambil setiap sesi yang terkait dengan pengguna.

Referensi API

Skema GET /v3/users//.

Ikhtisar

Harga

Alur Kerja & Verifikasi

Peninjauan & Operasional

Entitas (Pengguna & Bisnis)

Pengaturan & Kustomisasi

Keamanan & Kepatuhan

Didit Academy

Sumber Daya

Model Data Pengguna: Skema Pengguna Vendor

Kolom identitas

Status

Kolom agregat sesi

Peta `features`

Stempel waktu aktivitas

Metadata

Relasi (tidak disimpan di baris pengguna)

Contoh respons

Langkah selanjutnya

Operasi

Riwayat KYC

Referensi API

​Kolom identitas

​Status

​Kolom agregat sesi

​Peta features

​Stempel waktu aktivitas

​Metadata

​Relasi (tidak disimpan di baris pengguna)

​Contoh respons

​Langkah selanjutnya

Operasi

Riwayat KYC

Referensi API

Kolom identitas

Status

Kolom agregat sesi

Peta `features`

Stempel waktu aktivitas

Metadata

Relasi (tidak disimpan di baris pengguna)

Contoh respons

Langkah selanjutnya