Langsung ke konten utama
GET
cURL

Dukungan KYC dan KYB

Berlaku untuk sesi Verifikasi Pengguna (KYC) dan Verifikasi Bisnis (KYB). Didit secara otomatis mengarahkan ke templat PDF yang sesuai:
  • Sesi Verifikasi Pengguna (KYC) → laporan dengan bagian verifikasi identitas, Deteksi Liveness, pencocokan wajah, AML, dan POA.
  • Sesi Verifikasi Bisnis (KYB) → laporan dengan bagian registri perusahaan, pihak kunci (UBO/pejabat), dokumen, AML, kuesioner, telepon, email, dan analisis IP jika fitur tersebut termasuk dalam alur kerja.
Keduanya menggunakan alur pembuatan PDF yang sama dan mendukung kustomisasi White Label (logo, URL kebijakan privasi).

Konvensi nama file

Dikembalikan melalui header Content-Disposition: attachment; filename=....

Persyaratan status

Sesi harus berada di APPROVED, DECLINED, atau IN_REVIEW agar PDF dapat dibuat. Sesi yang sedang berjalan atau belum dimulai akan mengembalikan 403.

Contoh

White Label

Ketika aplikasi memiliki kustomisasi White Label yang aktif, PDF akan menggunakan logo dan URL kebijakan privasi Anda. Atur di Console → Customization.

Izin

Memerlukan read:sessions. Cakupan yang sama berlaku untuk kedua jenis.

Terkait

Otorisasi

x-api-key
string
header
wajib

Kunci API aplikasi Anda, dari Developers -> API keys di Business Console. Kunci utama memiliki akses penuh. Kunci bernama dapat diberi cakupan: none, read, atau write per sumber daya, dibatasi pada beberapa alur kerja atau pada sesi yang disetujui, pada daftar alamat IP, dan pada tanggal kedaluwarsa. 401 berarti kuncinya salah, dicabut, atau kedaluwarsa; 403 berarti tidak ada kunci yang dikirimkan, kunci tidak memiliki akses ke sumber daya atau tindakan ini, atau permintaan datang dari alamat di luar daftar IP-nya; 404 pada rute sesi berarti sesi berada di luar alur kerja atau status kunci tersebut. Kunci tanpa akses media menerima URL gambar, video, dan PDF sebagai null, dan kunci tanpa izin tulis sesi menerima tautan sesi dan token sebagai null. Lihat https://docs.didit.me/console/api-keys.

Parameter Path

sessionId
string<uuid>
wajib

UUID dari sesi Verifikasi Pengguna (KYC) atau Verifikasi Bisnis (KYB) yang akan dirender — session_id yang dikembalikan oleh POST /v3/session/. Path yang sama berlaku untuk kedua jenis sesi; gunakan nama file Content-Disposition pada respons untuk mengetahui jenis laporan yang Anda terima.

Harus berupa UUID huruf kecil dengan format yang benar. Rute ini hanya cocok dengan UUID yang valid, sehingga nilai yang salah format akan ditolak oleh router URL sebelum kode aplikasi apa pun berjalan dan responsnya adalah halaman HTML 404, bukan envelope JSON {"detail": ...} yang ditunjukkan di bawah ini. Pengonversi UUID rute hanya cocok dengan bentuk huruf kecil kanonikal — UUID heksadesimal huruf besar akan ditolak dengan HTML 404.

Contoh:

"11111111-2222-3333-4444-555555555555"

Respons

Dokumen PDF hasil render, dikembalikan langsung sebagai biner application/pdf — tidak ada pembungkus JSON dan tidak ada pengalihan URL unduhan. Isi dimulai dengan magic bytes %PDF (PDF 1.7). Simpan ke file .pdf atau alirkan langsung ke pemanggil Anda.

The response is of type file.

Terakhir diubah pada 7 November 2026