Langsung ke konten utama
Smart-ID dan Mobile-ID memungkinkan pengguna memverifikasi identitas mereka dengan menyetujui permintaan di ponsel mereka. Gunakan Smart-ID API atau Mobile-ID API untuk memulai verifikasi dari aplikasi Anda sendiri tanpa alur kerja. Kedua metode ini juga berjalan di dalam langkah alur kerja Verifikasi Identitas Didit, mengembalikan hasil verifikasi dompet dengan tingkat jaminan cryptographic. Untuk integrasi alur kerja yang di-hosting seperti yang dijelaskan di bawah ini, gunakan pembuatan sesi dan integrasi webhook yang sama seperti alur kerja Didit Anda lainnya.
Smart-ID dan Mobile-ID telah tersedia. Smart-ID mendukung Estonia, Latvia, Lithuania, dan Belgia. Mobile-ID mendukung Estonia dan Lithuania. Pilih dompet yang diterima alur kerja Anda untuk setiap negara di konsol. Lihat cakupan dan harga dompet untuk daftar lengkapnya.

​
Negara dan prasyarat

Integrasi ini mencakup Smart-ID di Estonia (EST), Latvia (LVA), Lithuania (LTU), dan Belgia (BEL). Mobile-ID mencakup Estonia (EST) dan Lithuania (LTU); Mobile-ID tidak ditawarkan untuk Latvia. Kode-kode negara ini menjelaskan rute yang terintegrasi, bukan janji bahwa setiap rute telah diaktifkan di lingkungan Anda. Untuk Smart-ID, pengguna memerlukan identitas Smart-ID aktif yang memenuhi syarat, kode identifikasi pribadinya, serta akses ke aplikasi tersebut. Untuk Mobile-ID, pengguna memerlukan identitas Mobile-ID aktif, kode identifikasi pribadinya, serta nomor telepon yang terkait dengannya. Masukkan nomor telepon Mobile-ID dalam format internasional: +372 untuk Estonia atau +370 untuk Lithuania. Negara yang dipilih harus cocok dengan identitas yang digunakan. Kedua metode tidak mengembalikan foto potret. Jika alur kerja Anda memerlukan swafoto, pastikan langkah Deteksi Liveness dan Pencocokan Wajah yang sesuai tetap dikonfigurasi secara terpisah.

​
Apa yang dilihat pengguna

  1. Pengguna memilih negara mereka dan memilih Smart-ID atau Mobile-ID dari dompet yang diterima alur kerja Anda.
  2. Sesi verifikasi meminta kode identifikasi pribadi; Mobile-ID juga meminta nomor telepon yang terkait.
  3. Halaman menampilkan kode perbandingan saat permintaan autentikasi dikirimkan ke ponsel.
  4. Pengguna memeriksa bahwa kode di ponsel cocok dengan kode di halaman verifikasi, lalu menyetujuinya menggunakan PIN mereka di ponsel.
  5. Didit memvalidasi hasil identitas yang ditandatangani dan melanjutkan alur kerja verifikasi.
Formulir identitas dan layar kode perbandingan menggunakan tata letak yang sama seperti metode verifikasi lainnya. Ketika kustomisasi White Label diaktifkan, layar-layar tersebut mewarisi warna, tipografi, gaya tombol, dan logo pelanggan sesi tersebut, serta tetap berada di domain sesi tersebut. Memuat ulang halaman akan memulihkan kode perbandingan yang aktif tanpa memulai permintaan persetujuan baru. Pengguna tidak pernah memasukkan PIN dompet mereka di halaman verifikasi. Jika kodenya berbeda atau pengguna tidak memprakarsai permintaan tersebut, mereka harus membatalkannya. Alur kode perbandingan berfungsi pada browser desktop atau ponsel dan tidak memerlukan kode QR. Halaman menunggu hasil secara otomatis dan menyediakan opsi pembatalan. Persetujuan di ponsel tetap harus lolos pemeriksaan identitas dan tanda tangan sebelum Didit menganggap verifikasi dompet tersebut berhasil.

​
Mengonfigurasi alur kerja

Di konsol, buka node Verifikasi Identitas alur kerja Anda, pilih Negara, lalu buka negara yang ingin Anda konfigurasikan. Di bawah Dompet yang diterima, pilih dompet yang tersedia dan tentukan perilaku saat terjadi kegagalan. Simpan dan publikasikan alur kerja sebelum membuat sesi baru. Lihat metode Verifikasi Identitas di konsol untuk jalur konsol selengkapnya.
Berikut ini adalah fragmen konfigurasi methods, bukan permintaan alur kerja yang lengkap. Gunakan ini hanya jika kedua smart_id dan mobile_id ditandai available untuk Estonia di lingkungan Anda. Dompet yang tidak tersedia akan menyebabkan penyimpanan seluruh alur kerja ditolak.
Array providers adalah daftar yang diizinkan: pengguna memilih di antara dompet-dompet di dalamnya, dan urutan array tidak menentukan dompet yang diutamakan. Untuk Lithuania, gunakan LTU dengan pengidentifikasi dompet yang sama jika keduanya tersedia. Untuk Latvia atau Belgia, gunakan LVA atau BEL hanya dengan smart_id, bergantung pada pemeriksaan ketersediaan yang sama. Negara yang dihilangkan akan mempertahankan perilaku pengambilan dokumen bawaannya yang sudah ada. Kontrak konfigurasi lengkap ada di Konfigurasi fitur alur kerja.

​
Membaca hasil yang diverifikasi

Baca sesi yang telah selesai melalui API keputusan sesi atau integrasi webhook Anda. Pemeriksaan dompet yang berhasil mencatat verification_method: "wallet", assurance: "cryptographic", dan wallet_provider: "smart_id" atau "mobile_id". Objek wallet_verification mengidentifikasi dompet, negara penerbit, waktu verifikasi, tingkat jaminan, dan putusan tanda tangan. Hasil verifikasi identitas menyediakan kolom full_name dan date_of_birth yang telah dinormalisasi. Untuk kedua dompet ini, wallet_verification.attributes memuat given_name, family_name, birthdate, dan personal_code dari identitas yang divalidasi. Negara penerbit mengidentifikasi rute identitas; hal ini tidak menetapkan kewarganegaraan orang tersebut. Didit mengembalikan putusan tanda tangan, bukan asersi bertanda tangan yang mendasarinya. Tidak ada foto potret atau PIN dompet yang dikembalikan. Di konsol, kartu Kredensial sesi menampilkan dompet dan bukti terverifikasinya. Pemeriksaan dompet yang berhasil menyelesaikan langkah Verifikasi Identitas; pemeriksaan selanjutnya dalam alur kerja Anda tetap menentukan keputusan akhir sesi. Lihat model data verifikasi identitas untuk tipe kolom dan perbedaan antara hasil pemeriksaan dan keputusan sesi secara keseluruhan.

​
Menangani pembatalan dan kegagalan

Jika pengguna membatalkan, kehabisan waktu, atau tidak dapat menyelesaikan autentikasi, Didit menerapkan pengaturan wallet.on_failure negara tersebut. fallback_to_document memulai pengambilan dokumen ketika fitur tersebut diaktifkan untuk negara tersebut. decline menolak langkah Verifikasi Identitas. Jika pengambilan dokumen dinonaktifkan, tidak ada fallback dokumen yang tersedia. Hanya pemeriksaan dompet yang selesai dan terverifikasi yang dikenakan biaya verifikasi dompet. Upaya dompet yang dibatalkan, kedaluwarsa, dan gagal tidak dikenakan biaya. Fallback dokumen yang selesai merupakan pemeriksaan terpisah berdasarkan harga verifikasi dokumen. Lihat tabel harga dompet untuk tarif yang dipublikasikan; metode tanpa tarif yang dipublikasikan tidak boleh dianggap gratis.

​
Pengujian sebelum produksi

Uji setiap dompet dan negara yang Anda rencanakan untuk ditawarkan di lingkungan tempat fitur tersebut diaktifkan. Pastikan bahwa dompet yang tepat muncul, kode pembanding terlihat, alur kerja berlanjut setelah persetujuan, dan hasil sesi memuat bukti dompet yang diharapkan. Periksa juga pembatalan, masa kedaluwarsa, dan perilaku fallback yang Anda pilih. Simulasi sandbox dan pengujian staging berbeda dari autentikasi produksi. Persetujuan yang disimulasikan berguna untuk memeriksa integrasi Anda, tetapi tidak membuktikan bahwa identitas nyata dapat diautentikasi dalam produksi. Sebelum peluncuran, konfirmasikan ketersediaan produksi di konsol dan selesaikan verifikasi resmi menggunakan perangkat nyata untuk rute yang ingin Anda gunakan.

​
Dompet identitas digital lainnya

Katalog dompet ID digital Didit mencakup ketersediaan produksi dan dompet yang akan datang, termasuk Finnish Trust Network yang telah tersedia serta integrasi BankID dan EUDI Wallet yang akan datang. Dompet yang tercantum, harga yang dipublikasikan, atau formulir onboarding yang telah diisi tidak serta-merta mengaktifkan autentikasi produksi. Gunakan katalog dan konsol lingkungan Anda untuk menentukan apa yang dapat Anda aktifkan hari ini. Lihat juga Finnish Trust Network untuk Finlandia.
Terakhir diubah pada 7 November 2026