cryptographic: penyedia identitas mengautentikasi individu tersebut dan menandatangani atribut yang dikembalikannya. Hanya itu yang dinyatakan oleh tingkat jaminan tersebut. Ini bukan peringkat terhadap dua tingkat lainnya — mereka menjelaskan bukti yang berbeda, bukan lebih banyak atau lebih sedikit dari hal yang sama — dan berapa lama proses masuk berlangsung bergantung pada alur dompet itu sendiri, yang tidak dikontrol maupun dijanjikan oleh Didit.
Pilih integrasi Anda
Gunakan API dompet identitas digital ketika aplikasi Anda mengelola antarmuka dan langkah-langkah autentikasi. Setiap dompet memiliki endpoint khusus untuk memulai, dengan endpoint hasil, polling, dan pembatalan bersama. Anda tidak perlu membuat alur kerja. Gunakan Sessions API untuk alur dompet yang di-hosting oleh Didit, aturan alur kerja, dan fallback dokumen yang dikonfigurasi. Ketersediaan dompet, persetujuan pengguna yang diperlukan, dan atribut identitas terverifikasi berlaku untuk kedua metode integrasi.Prasyarat
Setiap dompet memerlukan identitas aktif dengan penerbit yang disebutkan di bawah ini serta akses ke metode autentikasinya. Akun harus memenuhi syarat untuk atribut yang diminta, dan pengguna harus memberikan persetujuan untuk membagikannya. Tanda tangan memverifikasi penerbit dan klaim yang dikembalikan; tanda tangan tidak menjamin bahwa setiap atribut yang diminta ada, terkini, atau memadai untuk kebijakan kepatuhan Anda. Dompet tanpa potret wajah tidak menyertakan perbandingan swafoto. Semua 25 entri dompet dalam katalog tercantum di bawah ini, termasuk kedua negara yang memiliki BankID, ConnectID, Estonian ID-card, dan eParaksts mobile. Fallback dokumen yang dikonfigurasi menjalankan pemeriksaan dokumen terpisah. Tidak ada tanggal peluncuran yang dijanjikan. Ini adalah dompet identitas. Skrining dompet kripto memeriksa alamat blockchain untuk risiko keuangan dan merupakan produk terpisah.Harga
✅ Tersedia berarti diaktifkan di produksi. ⏳ Segera hadir berarti belum diaktifkan di produksi, meskipun pengujian integrasi telah dimulai. Dompet yang tersedia ditampilkan terlebih dahulu. Atas permintaan di kolom harga berarti dompet tersebut tersedia tetapi tidak memiliki tarif ritel yang dipublikasikan; ini bukan berarti verifikasi gratis. Ini adalah harga standar Didit dalam USD per verifikasi dompet yang selesai untuk produk identitas yang tercantum di bawah ini. Harga yang tercantum mencakup pemeriksaan identitas dompet; tidak ada biaya transaksi eID nasional terpisah yang ditambahkan ke dalamnya. Tarif khusus organisasi yang telah disepakati akan didahulukan.
Segera hadir di kolom harga berarti dompet tersebut direncanakan dan harga pelanggannya belum dipublikasikan. Ini tidak berarti verifikasinya gratis. Bendera negara menunjukkan cakupan katalog dompet; kolom ketersediaan terpisah menunjukkan apakah dompet saat ini dapat diaktifkan.
Harga yang dipublikasikan tidak mengaktifkan dompet. Ketersediaan di atas berasal dari katalog produksi. Dompet yang ditandai Segera hadir belum dapat dipilih dalam alur kerja; tarif ini berlaku ketika dompet tersebut telah tersedia.
- Masuk ke dompet yang berhasil diverifikasi ditagih satu kali per node Verifikasi Identitas dalam alur kerja, atau satu kali per permintaan verifikasi melalui API dompet mandiri. Callback atau pemeriksaan status berulang tidak menimbulkan biaya tambahan.
- Masuk yang dibatalkan, kedaluwarsa, ditolak, atau tidak lengkap tidak dikenakan biaya verifikasi dompet.
- Harga dompet adalah harga daftar: diskon paket Anda berlaku untuk harga tersebut sama seperti pemeriksaan lainnya.
- Pengalihan ke dokumen adalah pemeriksaan terpisah, yang ditagih berdasarkan harga verifikasi dokumen. Fitur alur kerja lain yang diselesaikan ditagih secara terpisah.
Apa yang dilakukan pengguna
- Memilih negara mereka pada langkah ID dan memilih dompet dari dompet yang Anda terima.
- Masuk dengan dompet tersebut, seperti saat mereka masuk ke bank atau portal pemerintah mereka.
- Menyetujui pembagian atribut identitas mereka dengan Anda.
- Kembali dalam status terverifikasi.
Dompet menggunakan daftar penerimaan
wallet.providers adalah daftar dompet yang dapat ditawarkan oleh suatu negara. Ini bukan pemeringkatan: urutan yang Anda kirimkan tidak memiliki arti, dinormalisasi ke urutan katalog saat disimpan, dan pengguna akhir memilih dari apa pun yang Anda terima. Aktifkan satu dompet atau semua dompet di suatu negara — pilihannya ada di tangan mereka.
API akan menolak alur kerja yang mengaktifkan dompet yang tidak ditawarkan oleh katalog di negara tersebut, atau dompet yang masih bertanda Segera hadir.
Daftar atribut setiap dompet di bawah ini mencakup atestasi bertanda tangan. Didit memverifikasi tanda tangan tersebut dan melaporkan keputusannya sebagai
wallet_verification.signature_valid pada sesi; atestasi itu sendiri tidak dikembalikan, sehingga tidak ada referensi untuk diambil atau disimpan. Kolom Pada sesi menunjukkan mana dari keduanya yang Anda dapatkan untuk setiap atribut.Dompet yang didukung
Dompet yang tersedia adalah MitID, BankID Sweden, iDIN, Finnish Trust Network, Smart-ID, dan Mobile-ID. iDIN tersedia untuk identifikasi penuh di Belanda. Smart-ID dan Mobile-ID tersedia di negara-negara yang tercantum dalam katalog di bawah ini. Cakupan negara dan input yang diminta untuk Smart-ID dan Mobile-ID mencerminkan integrasi yang diterapkan; ketersediaan produksi tetap dikendalikan secara terpisah. Gunakan panduan integrasi untuk rute Smart-ID dan Mobile-ID yang diterapkan.Ketersediaan disediakan oleh katalog kapabilitas, bukan dikelola secara manual di sini. Segera hadir berarti dompet tersebut terlihat di konsol dan belum dapat diaktifkan; ini tidak mencantumkan tanggal yang pasti.
Estonian ID-card dan eParaksts mobile
Kedua metode telah terintegrasi ke dalam katalog dompet namun tetap berstatus Segera hadir di produksi. Keduanya tidak dapat diaktifkan di alur kerja produksi sampai katalog produksi menandainya sebagai Tersedia. Pengidentifikasi API-nya adalahidcard_ee untuk Estonia (EST) dan eparaksts_mobile untuk Latvia (LVA).
Keduanya dihargai sebesar $0.55 per verifikasi yang selesai ketika tersedia; tarif yang dipublikasikan tidak serta-merta mengaktifkan akses produksi.
- Estonian ID-card: pengguna melanjutkan di browser pada komputer yang terhubung ke pembaca smart-card mereka dan melakukan autentikasi dengan kartu serta PIN mereka melalui perangkat lunak kartu.
- eParaksts mobile: pengguna melanjutkan ke layanan masuk identitas dan memberikan persetujuan dengan akun eParaksts mobile aktif mereka. Pengguna desktop dapat memindai kode QR untuk melanjutkan di ponsel mereka; pengguna ponsel melanjutkan secara langsung.
White Label berlaku untuk layar verifikasi Didit.
Layar autentikasi eksternal untuk kedua metode ini tetap mempertahankan merek layanan masing-masing.
Logo kustom, nama layanan, dan gaya White Label tidak diterapkan ke layar eksternal tersebut.
Menggunakan dompet ini melalui API
Kedua metode juga mendukung verifikasi API mandiri tanpaworkflow_id.
Ketersediaan produksi sama untuk API mandiri maupun alur kerja; periksa GET /v3/id-verification/wallets/ sebelum menawarkan salah satu metode kepada pengguna.
Simpan
x-api-key Anda di backend Anda dan daftarkan host pengembalian aplikasi Anda di pengaturan allowed_return_hosts.
Kirimkan return_url HTTPS pada host tersebut saat memulai verifikasi.
Respons awal mengembalikan request_id dan wallet_verification.next_action.url untuk browser pengguna.
Arahkan ulang pengguna ke URL tersebut agar mereka dapat melakukan autentikasi dengan kartu atau aplikasi mereka.
Setelah mereka kembali, panggil GET /v3/id-verification/wallets/verifications/{request_id}/ dari backend Anda untuk memeriksa hasil verifikasi, atau proses webhook status.updated yang telah ditandatangani.
Jangan menganggap pengalihan browser saja sebagai bukti bahwa verifikasi berhasil.
Harga serta aturan penagihan berdasarkan verifikasi yang selesai berlaku sama untuk kedua opsi integrasi.
Google Wallet
Google Wallet memungkinkan seseorang membagikan ID yang didukung pemerintah dari ponsel mereka dengan halaman atau aplikasi Anda, melalui W3C Digital Credentials API. Layanan ini tersedia di produksi dan di sandbox. Aplikasi sandbox tidak memerlukan pendaftaran. Setiap aplikasi produksi mendaftar sekali sebelum dapat menggunakan Google Wallet: di konsol, buka langkah verifikasi identitas, temukan baris Google Wallet dari negara yang didukung, pilih Daftar ke Google dan selesaikan penyiapan satu kali tersebut, yang memakan waktu sekitar satu menit. Google kemudian menampilkan nama dan logo Anda saat orang membagikan ID mereka. Sebelum aplikasi didaftarkan, penyimpanan alur kerja yang mengaktifkan Google Wallet akan ditolak dengan “Register this application with Google before enabling Google Wallet.” Pengguna akhir pelanggan Anda melihat opsi ini sebagai Verify with digital ID, karena selain Google Wallet, dompet Android lainnya yang mendukung permintaan OpenID4VP yang sama dan memegang ID yang kompatibel (ID pass atau lisensi mengemudi seluler) dapat meresponsnya.- Negara: Amerika Serikat, Inggris Raya, Brasil, Singapura, dan Taiwan.
- Kredensial: ID pass Google Wallet yang dibuat dari paspor, ditambah lisensi mengemudi seluler dari negara bagian AS yang didukung.
- Hasil yang dikembalikan: nama, tanggal lahir, nomor dokumen, tanggal kedaluwarsa dokumen, negara penerbit dan otoritas penerbit, serta kewarganegaraan untuk ID pass.
Hasil tersebut juga memuat keputusan
signature_validuntuk kredensial tersebut. Foto potret tidak dibagikan. - Privasi: Didit hanya meminta kolom yang diperlukannya, dan hanya kolom tersebut yang keluar dari dompet. Orang tersebut menyetujui pembagian di Google Wallet pada perangkat mereka sendiri.
digital-credentials-get ke atribut allow iframe Anda: tanpanya, browser akan menolak permintaan dompet di dalam iframe.
Dompet mendatang lainnya
ConnectID (Australia) telah terintegrasi untuk pengujian sandbox dan muncul di katalog dompet sebagaiconnectid.
Pengguna memilih bank uji yang berpartisipasi menggunakan pemilih ConnectID, masuk dengan bank tersebut, dan meninjau permintaan pembagian data.
Paket identitas awal meminta nama depan, nama belakang, dan tanggal lahir, beserta referensi transaksi untuk verifikasi.
Permintaan ini tidak meminta alamat, nomor telepon, alamat email, saldo rekening, atau riwayat transaksi.
Pemberitahuan pembagian data mengidentifikasi Didit dan bisnis yang menerima identitas terverifikasi.
Kredensial bank tetap berada di pihak bank.
Akses produksi tetap berstatus Segera hadir; pengujian sandbox tidak mengaktifkan verifikasi identitas di lingkungan produksi.
Kasus penggunaan produksi yang disetujui, onboarding pelanggan, ketentuan yang diwajibkan, dan sertifikasi harus diselesaikan sebelum aktivasi.
Dompet lain yang ditandai Segera hadir pada tabel juga belum tersedia di lingkungan produksi.
Tidak ada tanggal peluncuran yang dijanjikan.
Tingkat jaminan
Jika sebuah dompet menyediakan tingkat jaminan eIDAS (low, substantial, atau high), Didit mencatat tingkat yang benar-benar dinyatakan pada hasil tersebut.
Dompet tanpa tingkat eIDAS yang ditentukan, seperti ConnectID, ditampilkan sebagai Tidak ditentukan; integrasinya tidak menyiratkan klaim jaminan eIDAS.
Jika dompet mengembalikan tingkat yang lebih rendah dari yang diminta, proses masuk akan gagal alih-alih menurunkan tingkat secara diam-diam.
Periksa wallet_verification.level_of_assurance pada sesi jika aturan kepatuhan Anda bergantung padanya.
Referensi per dompet
MitID
mitid · Tersedia
Informasi yang dimasukkan di Didit: Nama · Tanggal lahir · Alias CPR (dipseudonimkan)
BankID
bankid_se · Tersedia
Informasi yang dimasukkan di Didit: Nama · Nomor identitas pribadi
iDIN
idin · Tersedia
Informasi yang dimasukkan di Didit: Nama · Tanggal lahir · Alamat
Finnish Trust Network
ftn · Tersedia
Informasi yang dimasukkan di Didit: Nama · Kode identitas pribadi
Google Wallet
google_wallet · Tersedia
Informasi yang dimasukkan di Didit: Tidak ada rincian identitas yang dimasukkan di Didit
Smart-ID
smart_id · Tersedia
Informasi yang dimasukkan di Didit: Kode identifikasi pribadi
Mobile-ID
mobile_id · Tersedia
Informasi yang dimasukkan di Didit: Kode identifikasi pribadi · Nomor telepon Mobile-ID
BankID
bankid_no · Segera hadir
Informasi yang dimasukkan di Didit: Nama · Tanggal lahir · Nomor identitas nasional
Vipps
vipps · Segera hadir
Informasi yang dimasukkan di Didit: Nama · Tanggal lahir · Nomor identitas nasional
Buypass ID
buypass · Segera hadir
Informasi yang dimasukkan di Didit: Nama · Tanggal lahir · Nomor identitas nasional
itsme
itsme · Segera hadir
Informasi yang dimasukkan di Didit: Nama · Tanggal lahir · Nomor registrasi nasional
Personalausweis
personalausweis · Segera hadir
Informasi yang dimasukkan di Didit: Nama · Tanggal lahir · Kewarganegaraan · Alamat
Freja eID
frejaid · Segera hadir
Informasi yang dimasukkan di Didit: Nama · Tanggal lahir · Nomor pribadi
UAE PASS
uae_pass · Segera hadir
Informasi yang dimasukkan di Didit: Nama · Nomor Emirates ID · Kewarganegaraan · Potret
gov.br
govbr · Segera hadir
Informasi yang dimasukkan di Didit: Nama · CPF
OneID
oneid · Segera hadir
Informasi yang dimasukkan di Didit: Nama · Tanggal lahir
GOV.UK Wallet
govuk_wallet · Segera hadir
Informasi yang dimasukkan di Didit: Nama · Tanggal lahir · Potret
Kartu identitas Estonia
idcard_ee · Segera hadir
Informasi yang dimasukkan di Didit: Nama · Tanggal lahir · Kode identifikasi pribadi
eParaksts mobile
eparaksts_mobile · Segera hadir
Informasi yang dimasukkan di Didit: Nama · Tanggal lahir · Kode identifikasi pribadi
Bank iD
bankid_cz · Segera hadir
Informasi yang dimasukkan di Didit: Nama · Tanggal lahir
MojeID
mojeid · Segera hadir
Informasi yang dimasukkan di Didit: Nama · Tanggal lahir
Diia
diia · Segera hadir
Informasi yang dimasukkan di Didit: Nama · Tanggal lahir · Potret
FranceConnect
franceconnect · Segera hadir
Informasi yang dimasukkan di Didit: Nama · Tanggal lahir
Auðkenni
audkenni · Segera hadir
Informasi yang dimasukkan di Didit: Nama · Kennitala
ConnectID
connectid · Segera hadir
Informasi yang dimasukkan di Didit: Tidak ada detail identitas yang dimasukkan di Didit
EUDI Wallet
eudi · Segera hadir
Informasi yang dimasukkan di Didit: PID - data identifikasi pribadi
Kegagalan dan cadangan
Apa pun selain
verified mengikuti pengaturan wallet.on_failure di negara tersebut: fallback_to_document mengarahkan pengguna ke pengambilan dokumen, decline mengakhiri sesi dengan Verifikasi Identitas yang ditolak. fallback_to_document dengan pengambilan dokumen yang dinonaktifkan untuk negara tersebut akan menolak sebagai gantinya, karena tidak ada tujuan cadangan.
Untuk menampilkan pengambilan dokumen hanya setelah proses masuk dompet gagal, lihat Tawarkan pengambilan dokumen hanya sebagai cadangan.
Hanya proses masuk yang selesai yang akan ditagih. Proses masuk yang ditinggalkan, dibatalkan, mengalami waktu habis, atau gagal tidak dikenakan biaya.
Data yang masuk ke sesi
attributes memuat klaim dompet yang telah divalidasi, yang namanya bervariasi bergantung pada dompetnya.
Gunakan full_name dan date_of_birth pada hasil Verifikasi Identitas untuk kolom identitas yang dinormalisasi.
Tabel per-dompet membedakan kolom yang dinormalisasi tersebut dari atribut spesifik dompet. portrait hanya ada untuk dompet yang membagikannya. signature_valid adalah hasil validasi asersi bertanda tangan yang dikembalikan dompet. Nilainya adalah true pada proses masuk yang selesai: asersi yang tidak lolos validasi akan menggagalkan proses masuk dan mengikuti wallet.on_failure, alih-alih menghasilkan hasil yang disetujui.
Tipe kolom lengkap ada di Model data Verifikasi Identitas.
Mengonfigurasi dompet
Ini adalah fragmen konfigurasi yang digunakan hanya jika katalog lingkungan Anda menandai setiap dompet yang dipilih sebagaiavailable di negara yang dipilih.
Mengirimkan dompet yang tidak tersedia akan menyebabkan penyimpanan seluruh alur kerja ditolak, termasuk metode lain apa pun dalam permintaan yang sama.
Untuk contoh Smart-ID dan Mobile-ID, lihat panduan integrasi.
wallet.enabled bernilai true, atau penyimpanan akan ditolak. Referensi lengkap ada di Konfigurasi fitur alur kerja.
Terkait
- Integrasi Finnish Trust Network - Finlandia, autentikasi bank, dan cadangan dokumen
- Integrasi Smart-ID dan Mobile-ID - cakupan negara, kode perbandingan, dan konfigurasi alur kerja
- Metode Verifikasi Identitas — tiga metode, cadangan, dan penagihan
- Pencarian non-dokumen — metode pencocokan data
- Metode Verifikasi Identitas di konsol — mengaktifkan dompet per negara