Referensi API Didit: REST API Verifikasi Identitas

Didit menawarkan dua pendekatan yang saling melengkapi untuk verifikasi identitas. Memahami perbedaannya sangat penting untuk memilih integrasi yang tepat bagi kasus penggunaan Anda.

Sesi yang Di-hosting (Direkomendasikan untuk Alur yang Berinteraksi Langsung dengan Pengguna)

Sesi yang di-hosting adalah pendekatan yang direkomendasikan untuk sebagian besar integrasi. Saat Anda membuat sesi, Didit menghasilkan verification_url yang Anda tampilkan kepada pengguna. Pengguna menyelesaikan seluruh alur verifikasi di antarmuka Didit yang telah dioptimalkan, dan Anda menerima hasilnya melalui webhook atau API.

Cara Kerjanya

Buat Sesi

Server Anda memanggil POST /v3/session/ dengan ID alur kerja. Didit mengembalikan verification_url dan session_token.

Tampilkan ke Pengguna

Arahkan pengguna, sematkan melalui iframe, atau inisialisasi SDK native menggunakan token sesi.

Pengguna Menyelesaikan Verifikasi

Pengguna mengikuti alur terpandu di UI Didit yang telah dioptimalkan, mencakup pengambilan ID, liveness, dan langkah tambahan apa pun.

Terima Hasil

Didit mengirim webhook ke server Anda beserta keputusan verifikasi, atau Anda melakukan polling melalui API untuk mengambil hasil.

Mengapa Sesi Direkomendasikan

Keunggulan	Rincian
UX yang Dioptimalkan	Antarmuka verifikasi terus diuji A/B secara global untuk mendapatkan tingkat penyelesaian tertinggi
Penanganan kamera	Pemilihan kamera cerdas, pengambilan otomatis, pemeriksaan kualitas, dan kompatibilitas perangkat sudah tersedia
Alur terpandu	Petunjuk langkah demi langkah, umpan balik real-time, dan pemulihan kesalahan bagi pengguna
Alur multi-fitur	Gabungkan beberapa fitur (ID + Liveness + AML + Telepon + Email) dalam satu alur
Keamanan	Anti-spoofing, deteksi liveness aktif, dan fingerprinting perangkat yang tertanam dalam alur
Kepatuhan	Jejak audit tingkat sesi, pengambilan persetujuan, dan kebijakan retensi data ditangani secara otomatis
Lokalisasi	54 bahasa dengan deteksi bahasa browser otomatis
Native untuk Perangkat Seluler	SDK native untuk iOS, Android, React Native, dan Flutter
Tanpa pemeliharaan	Didit menangani semua pembaruan UI, bug browser/perangkat, dan kasus khusus terkait kamera

Kapan Menggunakan Sesi

Onboarding pengguna / KYC: Pengguna baru mendaftar dan perlu memverifikasi identitasnya
Verifikasi usia: Pastikan pengguna memenuhi persyaratan usia minimum
Verifikasi ulang: Verifikasi ulang pengguna yang sudah ada secara berkala
Autentikasi Biometrik: Pengguna mengautentikasi dengan wajah mereka untuk tindakan sensitif
Kepatuhan multi-langkah: Alur yang memerlukan ID + Liveness + AML + Telepon sekaligus
Skenario apa pun saat pengguna akhir hadir dan berinteraksi langsung

Endpoint Sesi

Endpoint	Tujuan
Buat Sesi	Buat URL verifikasi untuk pengguna
Ambil Sesi	Ambil hasil lengkap dan keputusan untuk sesi
Daftar Sesi	Kueri dan filter semua sesi
Hapus Sesi	Hapus sesi beserta semua data terkait
Buat PDF	Ekspor laporan verifikasi sebagai PDF
Bagikan Sesi	Buat token berbagi untuk KYC yang Dapat Digunakan Kembali bersama mitra
Impor yang Dibagikan	Impor sesi yang dibagikan oleh mitra (KYC yang Dapat Digunakan Kembali)

API Standalone (Untuk Pemrosesan Server-ke-Server)

API Standalone memungkinkan Anda memanggil fitur verifikasi secara langsung dari server Anda tanpa antarmuka pengguna (UI). Anda mengirim data (gambar, dokumen, nama) dan menerima hasil yang terstruktur.

Cara Kerjanya

Kirim Data

Server Anda memanggil endpoint standalone (misalnya POST /v3/id-verification/) dengan data yang diperlukan: gambar, dokumen, atau kolom JSON.

Terima Hasil

Didit memproses permintaan secara sinkron dan mengembalikan hasil verifikasi yang terstruktur dalam respons.

Kapan Menggunakan API Standalone

Kasus Penggunaan	Contoh
Pemrosesan backend	Anda sudah memiliki gambar dokumen dari UI pengambilan gambar sendiri dan perlu memverifikasinya
Verifikasi batch	Memproses dokumen identitas dalam jumlah besar yang diunggah oleh tim operasional
UX kustom	Anda sudah membangun alur pengambilan gambar sendiri dan hanya ingin menggunakan Didit untuk analisisnya
Pemeriksaan server-ke-server	Skrining AML terhadap daftar pelanggan, tanpa interaksi pengguna apa pun
Pipeline otomatis	Pemeriksaan ulang kepatuhan berbasis CI/CD atau cron (misalnya pemantauan AML harian)
Integrasi dengan sistem yang ada	Menghubungkan verifikasi Didit ke sistem manajemen dokumen yang sudah Anda miliki
Panggilan fitur tunggal	Anda hanya membutuhkan satu fitur (misalnya hanya skrining AML atau hanya pencocokan wajah)

API Standalone yang Tersedia

Identitas & Dokumen

API	Fungsi
Verifikasi Identitas	Mengekstrak dan memvalidasi data dari dokumen identitas (gambar depan + belakang)
Bukti Alamat	Memverifikasi dokumen alamat (tagihan utilitas, rekening koran bank, dokumen pemerintah)
Validasi Alamat	Mengonfirmasi bahwa alamat ada dan mengembalikannya dalam bentuk yang dinormalisasi, beserta koordinat
Validasi Database	Memeriksa silang data pengguna dengan database pemerintah

Document AI

API	Fungsi
Document AI	Mengekstrak kolom yang Anda tentukan dari dokumen apa pun (PDF atau gambar), dengan pencocokan nama dan pemeriksaan manipulasi

Biometrik & Wajah

API	Fungsi
Liveness Pasif	Memverifikasi bahwa orang sungguhan hadir (pencegahan spoofing) dari satu gambar
Pencocokan Wajah	Membandingkan dua wajah untuk menentukan apakah keduanya orang yang sama
Pencarian Wajah	Mencari wajah di semua sesi yang telah diverifikasi sebelumnya (1:N)
Estimasi Usia	Memperkirakan usia seseorang dari gambar wajah

Kepatuhan & Risiko

API	Fungsi
Skrining AML	Menyaring individu atau perusahaan terhadap sanksi, PEP, dan daftar pantauan

Verifikasi bank

API	Fungsi
Pemeriksaan rekening	Memeriksa bahwa rekening bank milik orang atau perusahaan yang Anda sebutkan, sebelum Anda mengirim uang ke rekening tersebut

Verifikasi Bisnis (KYB)

API	Fungsi
Pencarian Registri KYB	Mencari registri perusahaan berdasarkan nama, nomor registrasi, dan negara; hingga $0.50 per permintaan yang berhasil
Pemilihan Registri KYB	Mengambil profil registri lengkap (pengurus, pemilik manfaat, alamat) untuk perusahaan yang dipilih

Perbandingan Berdampingan

	Sesi yang Di-hosting	API Standalone
Upaya integrasi	Rendah: redirect, iframe, atau SDK	Sedang: Anda menangani pengambilan dan pengiriman data
Interaksi pengguna	Ya: pengguna menyelesaikan alur di UI Didit	Tidak: hanya server-ke-server
Kamera/pengambilan gambar	Ditangani oleh Didit (dioptimalkan)	Anda menyediakan gambar/data
Alur multi-fitur	Ya: rangkai fitur dalam alur kerja	Satu fitur per panggilan API
Optimasi UX	Diuji A/B secara berkelanjutan	Anda yang mengontrol UX
Lokalisasi	54 bahasa, terdeteksi otomatis	Tidak berlaku (tanpa UI)
Webhook	Notifikasi status otomatis	Tidak berlaku (respons sinkron)
Waktu respons	Asinkron (pengguna menyelesaikan sesuai kecepatannya)	Sinkron (dalam hitungan detik)
Paling cocok untuk	Onboarding & verifikasi untuk pengguna	Pemrosesan backend & otomatisasi
Visibilitas di konsol	Siklus hidup sesi lengkap di dasbor	Muncul di bagian Pemeriksaan Manual

Bisakah Saya Menggunakan Keduanya?

Ya. Banyak tim mengombinasikan kedua pendekatan ini:

Sesi untuk onboarding: Pengguna baru menjalani alur verifikasi lengkap yang di-hosting saat pendaftaran
AML Standalone untuk pemantauan berkelanjutan: Tugas cron memeriksa ulang semua pengguna yang disetujui setiap malam terhadap daftar pantauan yang diperbarui
Pencarian Wajah Standalone untuk deteksi duplikasi: Saat sesi baru disetujui, server Anda memanggil Pencarian Wajah untuk memeriksa duplikasi
Verifikasi Identitas Standalone untuk operasional: Tim kepatuhan Anda mengunggah dokumen secara manual untuk peninjauan kasus khusus

Contoh: Arsitektur Gabungan

Aplikasi Anda	API Didit	Jenis
Alur pendaftaran pengguna	API Sesi (UI yang di-hosting)	Untuk pengguna
Pemeriksaan ulang AML setiap malam	API AML Standalone	Server-ke-server
Tinjauan dokumen tim operasional	API Verifikasi Identitas Standalone	Server-ke-server
Deteksi wajah duplikat	API Pencarian Wajah Standalone	Server-ke-server

Mulai

Terakhir diubah pada 7 November 2026

​Sesi yang Di-hosting (Direkomendasikan untuk Alur yang Berinteraksi Langsung dengan Pengguna)

​Cara Kerjanya

​Mengapa Sesi Direkomendasikan

​Kapan Menggunakan Sesi

​Endpoint Sesi

​API Standalone (Untuk Pemrosesan Server-ke-Server)

​Cara Kerjanya

​Kapan Menggunakan API Standalone

​API Standalone yang Tersedia

​Perbandingan Berdampingan

​Bisakah Saya Menggunakan Keduanya?

​Contoh: Arsitektur Gabungan

​Mulai

Sesi yang Di-hosting (Direkomendasikan untuk Alur yang Berinteraksi Langsung dengan Pengguna)

Cara Kerjanya

Mengapa Sesi Direkomendasikan

Kapan Menggunakan Sesi

Endpoint Sesi

API Standalone (Untuk Pemrosesan Server-ke-Server)

Cara Kerjanya

Kapan Menggunakan API Standalone

API Standalone yang Tersedia

Perbandingan Berdampingan

Bisakah Saya Menggunakan Keduanya?

Contoh: Arsitektur Gabungan

Mulai