Langsung ke konten utama
Panduan ini memandu Anda melalui verifikasi KYB lengkap dalam waktu kurang dari 10 menit. Anda akan membuat alur kerja, memulai sesi, mengirimkan tautan verifikasi yang di-hosting kepada kontak bisnis Anda, menunggu webhook, lalu mengambil keputusan akhir.

Prasyarat

  • Aplikasi Didit dengan KYB aktif. Buat di business.didit.me jika belum ada.
  • Kunci API dari Developer Settings → API Keys.
  • Endpoint webhook yang dapat dijangkau dari internet (untuk webhook keputusan).

Langkah-langkah

1

Buat alur kerja KYB di konsol

Buka Workflows → Create workflow. Pilih Verifikasi Bisnis sebagai jenis alur kerja.Aktifkan fitur yang Anda butuhkan:
  • Pencarian registri perusahaan (wajib)
  • AML Perusahaan (direkomendasikan)
  • Pihak Kunci (wajib untuk sebagian besar industri yang diatur)
  • Dokumen (opsional, pilih jenis dokumen yang Anda perlukan)
Simpan dan salin workflow_id, karena Anda akan menggunakannya pada langkah berikutnya.
2

Buat sesi Verifikasi Bisnis (KYB) melalui API

Respons berisi session_id, session_number, dan url, yaitu tautan verifikasi yang di-hosting yang Anda kirimkan kepada kontak bisnis. Jenis alur kerja (KYB) secara otomatis menandai sesi sebagai sesi bisnis.
3

Kirim tautan kepada kontak bisnis Anda

Kirimkan url kepada admin perusahaan melalui email atau chat Anda sendiri. Mereka akan membukanya, mengisi data registri, menambahkan pihak kunci dan UBO, lalu mengunggah dokumen.Anda dapat menyesuaikan pengalaman yang di-hosting dengan branding, logo, dan domain. Lihat White Label.
4

Terima webhook status

Ketika bisnis menyelesaikan alur dan pemrosesan KYB mencapai status terminal, Didit mengirimkan event status.updated dengan metode POST ke endpoint webhook Anda. Event sesi bisnis membawa session_kind: "business" di dalam data. Gunakan nilai tersebut untuk memfilter dan mengarahkan event ke handler KYB Anda.Verifikasi tanda tangan HMAC X-Signature-V2 sebelum mempercayai event (lihat webhooks), lalu jalankan logika downstream Anda. Simpan secret_shared_key dari tujuan (dikembalikan saat Anda mendaftarkan webhook) sebagai DIDIT_WEBHOOK_SECRET di .env Anda.Contoh payload:
5

Ambil keputusan (opsional)

Payload webhook status.updated sudah berisi keputusan lengkap. Anda hanya perlu memanggil endpoint ini jika tidak berlangganan webhook, atau jika Anda ingin mengambil keputusan sesuai permintaan nanti.
Keputusan mencakup data registri, pihak kunci (UBO, pemegang saham, direktur, dan perwakilan), temuan AML, dokumen, dan hasil per fitur. Lihat skema respons untuk referensi payload lengkap.
6

Tindak lanjuti keputusan

Berdasarkan status:
  • "Approved": lakukan onboarding bisnis.
  • "Declined": tolak dan catat tag warnings[] dari keputusan.
  • "In Review": tunggu keputusan analis. Anda akan menerima webhook lain saat hasilnya sudah final.

Contoh Node.js

Yang terjadi secara otomatis

  • Pencarian registri perusahaan di 190+ yurisdiksi.
  • Ekstraksi UBO dan pejabat dari data registri.
  • Skrining AML tingkat perusahaan (sanksi, PEP, media negatif).
  • AML tingkat individu untuk setiap pihak yang teridentifikasi.
  • OCR dokumen dan pencocokan silang.
  • Pembuatan dan agregasi profil bisnis yang dikelompokkan berdasarkan vendor_data.

Langkah berikutnya

Panduan integrasi

Arsitektur end-to-end, polling vs webhook, dan logika coba lagi.

Webhook KYB

Setiap event KYB dan bentuk payload-nya.

Status

Referensi status sesi, fitur, dan registri.

Skema respons

Payload keputusan KYB lengkap.

Entitas bisnis

Cara profil diagregasi lintas sesi.
Terakhir diubah pada 7 November 2026