Langsung ke konten utama
Sesi adalah unit verifikasi di Didit. Saat Anda memulai verifikasi, sesi dibuat. Ketika verifikasi selesai, sesi berisi payload keputusan lengkap. API sesi yang sama menangani kedua jenis: Dalam pelajaran Academy tentang apa yang dilihat pengguna, bab 5:34 membahas trade-off antara alur yang di-hosting dan membangun layar Anda sendiri. Inilah trade-off yang ditentukan oleh API ini untuk Anda.

​
Jenis ditentukan oleh alur kerja

Saat Anda membuat sesi, Anda mengirim workflow_id. Jenis alur kerja menentukan apakah sesi tersebut Verifikasi Pengguna atau Verifikasi Bisnis. Pemanggil tidak memilih jenisnya secara terpisah. Alur kerja KYB membuat sesi Verifikasi Bisnis, dan alur kerja KYC membuat sesi Verifikasi Pengguna.

​
Diskriminator session_kind

Setiap respons sesi, baik saat membuat, mengambil, mencantumkan, memperbarui status, membagikan, maupun mengimpor, menyertakan kolom tingkat atas berikut:
  • "user": sesi tersebut adalah Sesi Verifikasi Pengguna (KYC). Respons berisi array fitur khusus pengguna.
  • "business": sesi tersebut adalah Sesi Verifikasi Bisnis (KYB). Respons berisi array fitur khusus bisnis.
Gunakan kolom ini untuk menentukan struktur respons di sisi Anda.
Nilai enum berupa identifier pendek "user" dan "business". Kami membuatnya pendek agar API lebih mudah digunakan. Nama lengkap Verifikasi Pengguna (KYC) dan Verifikasi Bisnis (KYB) dipakai di seluruh dokumentasi agar lebih jelas.

​
Array fitur berdasarkan jenis

Array fitur yang ada dalam sebuah keputusan bergantung pada jenisnya. Kolom yang tidak berlaku untuk satu jenis tidak muncul dalam respons tersebut (tanpa null, tanpa placeholder):

​
Kolom tingkat atas bersama

Setiap sesi (kedua jenis) memuat kolom berikut:

​
Endpoint yang tercakup

Endpoint berikut menerima kedua jenis. Tidak ada jalur /v3/business-session/* yang terpisah.

​
Cara kerja pencarian

Sesi Verifikasi Pengguna dan sesi Verifikasi Bisnis adalah dua jenis yang berbeda. ID menggunakan UUID sehingga tabrakan tidak mungkin terjadi. Saat Anda memanggil endpoint dengan session_id, Didit akan:
  1. Mencari ID di tabel Verifikasi Pengguna terlebih dahulu (mencakup sebagian besar trafik).
  2. Jika tidak ditemukan, mencarinya di tabel Verifikasi Bisnis.
  3. Mengembalikan 404 jika tidak ada tabel yang memiliki kecocokan.
Anda tidak perlu memberi tahu API jenis apa yang Anda cari.

​
Status identik untuk kedua jenis

Nilai status sama untuk kedua jenis, dan API mengembalikannya persis seperti yang tertulis di sini: "Not Started", "In Progress", "Approved", "Declined", "In Review", "Abandoned", "Expired", "Kyc Expired", "Resubmitted", "Awaiting User". Pencocokan bersifat tepat dan sensitif terhadap huruf besar-kecil. Lihat status verifikasi untuk referensi lengkap.

​
Webhook

Event webhook sudah membawa kolom session_kind agar handler webhook Anda dapat mendistribusikan event per jenis: Lihat webhook untuk verifikasi tanda tangan dan semantik percobaan ulang, serta webhook KYB untuk katalog event webhook Verifikasi Bisnis (KYB).

​
Langkah selanjutnya

Buat sesi

Mulai verifikasi untuk Verifikasi Pengguna atau Verifikasi Bisnis (KYB).

Ambil sesi

Ambil keputusannya. Berlaku untuk kedua jenis.

Daftar sesi

Filter berdasarkan session_kind.

Perbarui status

Setujui, tolak, tinjau, ajukan ulang.

Hasilkan PDF

Laporan PDF per jenis.

Bagikan + impor

Pindahkan sesi antar aplikasi.
Terakhir diubah pada 7 November 2026