Vendor Data Linking: Hubungkan ID ke Entitas

vendor_data adalah pengenal yang Anda berikan pada setiap sesi dan transaksi untuk menautkannya ke entitas Pengguna atau Bisnis. Ini adalah kolom terpenting untuk agregasi entitas. Jika diisi dengan benar, setiap fitur lanjutan (riwayat profil, pemantauan transaksi, penegakan daftar blokir, dan AML berkelanjutan) akan berfungsi dengan lancar.

Apa itu

vendor_data adalah string yang Anda pilih sendiri. Didit memperlakukannya sebagai pengenal opak dan tidak menafsirkan isinya. Contoh nilai yang umum:

Sistem Anda	Contoh nilai `vendor_data` yang baik
Database pengguna internal	`user_1234`, `uuid-v4` milik pengguna
ID yang terlihat oleh pelanggan	`CUST-2026-00042`, hash dari email
SaaS multi-tenant	`tenant_acme:user_1234`
Platform B2B	`company-hq-global`, `tax-id-US-123456789`

Jangan pernah memasukkan PII (email, nomor telepon, ID pajak mentah) langsung ke vendor_data. Lakukan hash atau beri awalan pada data tersebut. vendor_data muncul di payload webhook dan disimpan tanpa batas waktu selama entitas masih ada.

Cara mengikat semuanya

Ketika Anda mengirim sesi atau transaksi dengan nilai vendor_data:

Didit mencari entitas di aplikasi Anda dengan vendor_data tersebut.
Jika entitas itu ada, objek baru ditautkan ke entitas tersebut.
Jika entitas itu tidak ada, Didit membuat entitas (dengan status: ACTIVE) dan menautkan objek baru.

Hal ini berlaku untuk:

POST /v3/session/: sesi KYC dan Verifikasi Bisnis (KYB)
POST /v3/transactions/: transaksi (untuk pemohon dan pihak lawan)
Kolom applicant.vendor_data / counterparty.vendor_data di dalam payload transaksi

Keunikan dan cakupan

vendor_data unik per aplikasi, bukan secara global di seluruh Didit:

Cakupan	Jaminan keunikan
Dalam satu aplikasi	`vendor_data` unik per jenis entitas (Pengguna dan Bisnis adalah ruang nama terpisah)
Lintas aplikasi dalam organisasi Anda	`vendor_data` tidak dibagikan. Nilai yang sama di dua aplikasi merujuk pada dua entitas yang berbeda
Lintas organisasi	Tidak dibagikan. Setiap organisasi memiliki tabel entitasnya sendiri

Artinya, Anda dapat menggunakan vendor_data yang sama di aplikasi staging dan aplikasi produksi tanpa konflik. Anda juga dapat memiliki Pengguna user-42 dan Bisnis user-42 tanpa konflik, meskipun hal ini tidak disarankan demi kejelasan.

Apa yang terjadi jika Anda tidak menyertakan `vendor_data`

Anda dapat membuat sesi tanpa vendor_data. Dalam kasus itu:

Tidak ada entitas yang dibuat untuk sesi tersebut.
Sesi menjadi tidak tertaut ke entitas mana pun. Sesi tidak akan muncul di profil Pengguna atau Bisnis mana pun.
Anda tidak dapat mencari sesi berdasarkan vendor_data di kemudian hari. Pencarian hanya dapat dilakukan berdasarkan session_id.

Gunakan pola ini hanya untuk verifikasi anonim atau sekali pakai yang tidak memerlukan agregasi entitas. Untuk setiap integrasi yang melibatkan verifikasi ulang, transaksi, atau pemantauan berkelanjutan, selalu sertakan vendor_data.

Contoh: buat entitas terlebih dahulu, lalu jalankan sesi

# 1. Pre-create the User with initial metadata
curl -X POST https://verification.didit.me/v3/users/create/ \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "vendor_data": "user-42",
    "display_name": "Jane Doe",
    "metadata": { "tier": "premium", "signup_date": "2026-04-01" }
  }'

# 2. Create a User Verification (KYC) session for the same user
curl -X POST https://verification.didit.me/v3/session/ \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "workflow_id": "wf_kyc_standard",
    "vendor_data": "user-42"
  }'

# 3. Later, submit a transaction tied to the same user
curl -X POST https://verification.didit.me/v3/transactions/ \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "txn_id": "tx-0001",
    "direction": "OUTBOUND",
    "amount": "500.00",
    "currency": "EUR",
    "applicant": { "vendor_data": "user-42" },
    "counterparty": { "name": "Acme Corp" }
  }'

Ketiga panggilan tersebut ditautkan ke entitas Pengguna yang sama. Saat nanti Anda memanggil GET /v3/users/user-42/, Anda akan melihat jumlah sesi, penghitung persetujuan dan penolakan, transaksi yang ditautkan, serta data profil terbaru.

Memigrasikan ID eksternal

Jika Anda beralih ke Didit setelah menggunakan vendor KYC lain, teruskan ID pengguna stabil yang sudah ada sebagai vendor_data sejak hari pertama. Cara ini memudahkan Anda untuk:

Mencocokkan data Didit dengan database internal Anda.
Memuat massal pengguna historis melalui impor CSV di konsol sebelum menjalankan sesi apa pun.
Mempertahankan relasi saat Anda kemudian bermigrasi ke Didit untuk pemantauan transaksi.

Aturan, konvensi, dan praktik terbaik

Aturan	Alasan
Pilih satu pengenal kanonik per entitas dan jangan pernah mengubahnya	Perubahan akan membuat entitas baru dan membuat riwayat menjadi terisolasi
Beri awalan pada nilai `vendor_data` sesuai jenis entitas (`user_...`, `biz_...`)	Mencegah konflik yang tidak disengaja antar-ruang nama dalam kode Anda sendiri
Jaga agar `vendor_data` peka huruf besar-kecil dan tetap stabil	Didit tidak menormalkan huruf besar-kecil
Jaga panjang `vendor_data` di bawah 128 karakter	Cocok untuk indeks database
Jangan pernah menampilkan PII mentah	`vendor_data` muncul di webhook, log audit, dan respons API

Langkah selanjutnya

Ikhtisar Pengguna

Pembahasan mendalam tentang entitas Pengguna dan operasinya.

Ikhtisar Bisnis

Pembahasan mendalam tentang entitas Bisnis dan operasinya.

Buat sesi

Mulai verifikasi untuk sebuah vendor_data.

Buat transaksi

Kirim transaksi yang ditautkan ke entitas.

Ikhtisar

Harga

Alur Kerja & Verifikasi

Peninjauan & Operasional

Entitas (Pengguna & Bisnis)

Pengaturan & Kustomisasi

Keamanan & Kepatuhan

Didit Academy

Sumber Daya

Vendor Data Linking: Hubungkan ID ke Entitas

Apa itu

Cara mengikat semuanya

Keunikan dan cakupan

Apa yang terjadi jika Anda tidak menyertakan `vendor_data`

Contoh: buat entitas terlebih dahulu, lalu jalankan sesi

Memigrasikan ID eksternal

Aturan, konvensi, dan praktik terbaik

Langkah selanjutnya

Ikhtisar Pengguna

Ikhtisar Bisnis

Buat sesi

Buat transaksi

​Apa itu

​Cara mengikat semuanya

​Keunikan dan cakupan

​Apa yang terjadi jika Anda tidak menyertakan vendor_data

​Contoh: buat entitas terlebih dahulu, lalu jalankan sesi

​Memigrasikan ID eksternal

​Aturan, konvensi, dan praktik terbaik

​Langkah selanjutnya

Ikhtisar Pengguna

Ikhtisar Bisnis

Buat sesi

Buat transaksi

Apa itu

Cara mengikat semuanya

Keunikan dan cakupan

Apa yang terjadi jika Anda tidak menyertakan `vendor_data`

Contoh: buat entitas terlebih dahulu, lalu jalankan sesi

Memigrasikan ID eksternal

Aturan, konvensi, dan praktik terbaik

Langkah selanjutnya