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

# Model Data Pengguna: Skema Pengguna Vendor

> Setiap kolom entitas User Didit: identitas, status, agregat sesi KYC, biometrik, timestamp aktivitas, dan metadata. Harga bayar sesuai pemakaian.

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](https://docs.didit.me/id/entities/vendor-data-linking.md). |
| `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. |

> [!NOTE]
>
> `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](https://docs.didit.me/id/entities/lifecycle.md). |

## 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](https://docs.didit.me/id/core-technology/email-verification/overview.md) |
| `approved_phones[]` | array string | Nomor telepon yang diverifikasi melalui [Verifikasi Telepon](https://docs.didit.me/id/core-technology/phone-verification/overview.md) |
| `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:

```json theme={null}
{
  "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](https://docs.didit.me/id/management-api/lists/overview.md): filter entri menggunakan pengenal pengguna |

## Contoh respons

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

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

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

> [card] [Referensi API](https://docs.didit.me/id/management-api/users/get.md)
>
> Skema GET /v3/users/{vendor_data}/.


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