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)
workflow_id, karena Anda akan menggunakannya pada langkah berikutnya.2
Buat sesi Verifikasi Bisnis (KYB) melalui API
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.6
Tindak lanjuti keputusan
Berdasarkan
status:"Approved": lakukan onboarding bisnis."Declined": tolak dan catat tagwarnings[]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.