Blog · 21 Mei 2026

Siklus Hidup Sesi KYB: Status dan Webhook (ID)

Lacak verifikasi KYB secara menyeluruh — status sesi, status per fitur, status entitas bisnis, dan webhook yang menjaga rekaman Anda tetap sinkron — dengan biaya $2,00 per perusahaan.

Oleh Didit21 Mei 2026Diperbarui 21 Mei 2026

Verifikasi KYB bukanlah jawaban ya/tidak tunggal — ini adalah proses dengan bagian-bagian yang bergerak. Pencarian registri mungkin langsung disetujui sementara verifikasi dokumen menunggu pengiriman ulang dan AML entitas dalam peninjauan menunggu analis. Untuk mengintegrasikan KYB dengan bersih, Anda perlu mengetahui dengan tepat bagaimana kondisi setiap bagian verifikasi, dan Anda memerlukan sistem Anda sendiri untuk memperbarui saat salah satu status tersebut berubah. Itulah gunanya siklus hidup sesi dan webhook.

API Verifikasi Bisnis Didit mengekspos mesin status lengkap: status pada sesi keseluruhan, status pada setiap fitur, serangkaian status terpisah untuk entitas bisnis setelah dikelola, dan webhook yang aktif pada setiap perubahan. Verifikasi perusahaan lengkap adalah $2,00, dan panduan ini memetakan seluruh siklus hidup — setiap status, setiap webhook, dan API manajemen yang mengikatnya bersama.

Poin-poin penting

Tiga lapisan status. Verifikasi KYB memiliki status sesi, status per fitur, dan — setelah dikelola — status entitas bisnis.
Delapan status sesi. NOT_STARTED, IN_PROGRESS, APPROVED, DECLINED, IN_REVIEW, RESUBMITTED, ABANDONED, EXPIRED.
Enam status fitur pada masing-masing dari empat fitur KYB: NOT_FINISHED, APPROVED, DECLINED, IN_REVIEW, RESUB_REQUESTED, AWAITING_USER.
Tiga status entitas dalam manajemen: ACTIVE, FLAGGED, BLOCKED.
Webhook pada semuanya. status.updated dan data.updated (dengan session_kind: business) untuk sesi; business.status.updated dan business.data.updated untuk entitas yang dikelola.
API manajemen lengkap — POST /v3/businesses/create/, GET /v3/businesses/, GET /v3/businesses/{vendor_data}/, PATCH .../update-status/.

Apa yang dicakup siklus hidup KYB

Verifikasi KYB menghasilkan status pada tiga lapisan, dan masing-masing menjawab pertanyaan yang berbeda:

Sesi menjawab "bagaimana verifikasi berjalan secara keseluruhan?"
Setiap fitur menjawab "bagaimana pemeriksaan registri / AML perusahaan / dokumen / orang kunci?"
Entitas bisnis menjawab "bagaimana status operasional perusahaan ini dalam sistem kami saat ini?"

Anda membaca ketiganya, dan Anda menjaganya tetap sinkron dengan webhook daripada polling. Verifikasi dimulai sebagai sesi, menyelesaikan fiturnya, menghasilkan hasil keseluruhan, dan kemudian — setelah Anda mulai mengelola perusahaan — membawa status entitas bisnis yang Anda kontrol saat keadaan berubah.

Mengapa itu penting

Tanpa status yang terperinci, integrasi KYB menjadi tebak-tebakan: satu tanda "pending" tidak memberi tahu Anda pemeriksaan mana yang menahan atau tindakan apa yang akan membukanya. Dengan status per fitur, Anda dapat merutekan dengan tepat — meminta pemohon untuk mengirim ulang dokumen, mengantrekan pencocokan AML entitas untuk ditinjau analis, meminta UBO untuk menyelesaikan KYC mereka — daripada menggagalkan seluruh verifikasi.

Webhook penting karena KYB bersifat asinkron. Data registri, OCR dokumen, dan hasil penyaringan tiba pada waktu yang berbeda, dan tinjauan manusia membutuhkan waktu lebih lama. Polling untuk perubahan membuang-buang waktu dan lambat; webhook mendorong perubahan saat itu terjadi, sehingga catatan Anda mencerminkan kenyataan tanpa cron job yang membebani API.

Detail teknis

Sesi KYB dibuat terhadap API /v3/ terpadu dan melaporkan kembali status siklus hidupnya.

curl -X POST https://verification.didit.me/v3/session/ \
  -H "x-api-key: $DIDIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "workflow_id": "your_kyb_workflow_id",
    "vendor_data": "merchant_6601",
    "callback": "https://yourapp.com/kyb/callback"
  }'

Webhook status.updated membawa status sesi dan status per fitur:

{
  "event": "status.updated",
  "session_kind": "business",
  "session_id": "kyb_3a90f1c2",
  "vendor_data": "merchant_6601",
  "status": "IN_REVIEW",
  "features": {
    "kyb_registry": "APPROVED",
    "kyb_company_aml": "IN_REVIEW",
    "kyb_documents": "RESUB_REQUESTED",
    "kyb_key_people": "APPROVED"
  }
}

Status sesi. NOT_STARTED, IN_PROGRESS, APPROVED, DECLINED, IN_REVIEW, RESUBMITTED, ABANDONED, EXPIRED.

Status fitur. Masing-masing dari kyb_registry, kyb_company_aml, kyb_documents, dan kyb_key_people melaporkan salah satu dari: NOT_FINISHED, APPROVED, DECLINED, IN_REVIEW, RESUB_REQUESTED, AWAITING_USER.

Webhook. Untuk sesi: status.updated (perubahan siklus hidup) dan data.updated (data yang diperkaya), keduanya membawa session_kind: "business". Untuk entitas yang dikelola: business.status.updated dan business.data.updated.

Harga. $2,00 per verifikasi perusahaan.

Mengelola entitas bisnis

Setelah perusahaan diverifikasi, ia menjadi entitas yang Anda kelola melalui API bisnis:

POST /v3/businesses/create/ — mendaftarkan entitas bisnis.
GET /v3/businesses/ — daftar bisnis yang dikelola.
GET /v3/businesses/{vendor_data}/ — mengambil satu bisnis berdasarkan referensi vendor_data-nya.
PATCH .../update-status/ — mengubah status entitas.

Entitas membawa statusnya sendiri, terlepas dari sesi verifikasi: ACTIVE (dalam kondisi baik), FLAGGED (dalam peninjauan untuk sinyal risiko), atau BLOCKED (ditangguhkan). Ini adalah lapisan operasional — sebuah perusahaan dapat menyelesaikan sesi APPROVED dan kemudian di FLAGGED karena pemantauan menemukan sesuatu. Perubahan pada entitas memancarkan business.status.updated dan business.data.updated agar sistem hilir tetap terkini.

Siklus hidup, dari awal hingga akhir

Verifikasi tipikal berjalan melalui lapisan secara berurutan. Sesi dibuka di NOT_STARTED, bergerak ke IN_PROGRESS saat fitur berjalan, dan setiap fitur diselesaikan — registri APPROVED, dokumen mungkin RESUB_REQUESTED hingga unggahan bersih tiba, AML perusahaan IN_REVIEW hingga analis membersihkan kecocokan, orang kunci APPROVED. Ketika setiap fitur selesai, sesi berakhir pada APPROVED, DECLINED, atau IN_REVIEW. Dari sana perusahaan memasuki manajemen sebagai entitas ACTIVE, dan statusnya kemudian dapat bergerak ke FLAGGED atau BLOCKED sesuai kebutuhan pengawasan berkelanjutan — setiap transisi didorong kepada Anda oleh webhook.

Kasus penggunaan

Marketplace merutekan penjual dengan tepat: mengirim ulang dokumen, menyelesaikan KYC UBO, atau menahan kecocokan AML entitas — tanpa menggagalkan seluruh orientasi.
Fintech dan perbankan menjaga catatan akun perusahaan tetap sinkron dengan webhook alih-alih polling, dan menandai atau memblokir entitas saat risiko berubah.
Penyedia pinjaman melacak status setiap pemeriksaan penjaminan emisi dan memperbarui status peminjam melalui API manajemen.
Platform Crypto B2B mempertahankan siklus hidup yang dapat diaudit dari setiap entitas pihak lawan mulai dari verifikasi hingga status berkelanjutan.

Cara berintegrasi dengan Didit

Bangun alur kerja. Di Konsol Bisnis, buat alur kerja KYB dengan fitur yang Anda butuhkan.
Buat sesi. POST /v3/session/ dengan workflow_id KYB Anda dan referensi vendor_data.
Berlangganan webhook. Tangani status.updated dan data.updated (session_kind: business) untuk sesi, dan business.status.updated / business.data.updated untuk entitas yang dikelola.
Kelola entitas. Gunakan POST /v3/businesses/create/, GET /v3/businesses/, GET /v3/businesses/{vendor_data}/, dan PATCH .../update-status/ untuk menjaga setiap perusahaan ACTIVE, FLAGGED, atau BLOCKED.

Karena semuanya ada di API /v3/ terpadu, model siklus hidup yang sama berlaku di seluruh KYC, pemantauan, dan KYB — satu mesin status yang konsisten untuk seluruh platform identitas dan penipuan.

Pertanyaan yang sering diajukan

Apa saja status sesi KYB?

NOT_STARTED, IN_PROGRESS, APPROVED, DECLINED, IN_REVIEW, RESUBMITTED, ABANDONED, dan EXPIRED.

Status apa yang dilaporkan oleh fitur individual?

Masing-masing dari kyb_registry, kyb_company_aml, kyb_documents, dan kyb_key_people melaporkan NOT_FINISHED, APPROVED, DECLINED, IN_REVIEW, RESUB_REQUESTED, atau AWAITING_USER.

Webhook mana yang harus saya langgan?

Untuk sesi, status.updated dan data.updated (dengan session_kind: business). Untuk entitas bisnis yang dikelola, business.status.updated dan business.data.updated.

Bagaimana cara mengubah status perusahaan setelah verifikasi?

Gunakan API manajemen — PATCH .../update-status/ — untuk mengatur entitas menjadi ACTIVE, FLAGGED, atau BLOCKED.

Berapa biaya verifikasi KYB?

$2,00 per perusahaan untuk verifikasi lengkap — registri, UBO, petugas, dan AML entitas.

Siap untuk memulai?

Baca gambaran umum Verifikasi Bisnis di dokumen, lihat bagaimana itu cocok dengan bagian platform lainnya di halaman produk Verifikasi Bisnis, dan periksa harga per panggilan yang transparan di halaman harga. Setelah Anda siap, mulai gratis — 500 pemeriksaan KYC gratis setiap bulan, dan verifikasi bisnis dengan biaya $2,00 per perusahaan.