> ## Documentation Index
> Fetch the complete documentation index at: https://docs.didit.me/llms.txt
> Use this file to discover all available pages before exploring further.

# Integrasi Smart-ID dan Mobile-ID: Panduan

> Konfigurasikan verifikasi identitas Smart-ID dan Mobile-ID di Didit, termasuk cakupan negara, autentikasi kode, atribut terverifikasi, dan fallback.

Smart-ID dan Mobile-ID memungkinkan pengguna memverifikasi identitas mereka dengan menyetujui permintaan di ponsel mereka.
Gunakan [Smart-ID API](https://docs.didit.me/id/api-reference/digital-id-wallets/smart-id.md) atau [Mobile-ID API](https://docs.didit.me/id/api-reference/digital-id-wallets/mobile-id.md) 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.

> [!NOTE]
>
> **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](https://docs.didit.me/id/core-technology/id-verification/digital-id-wallets.md#harga) 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](https://docs.didit.me/id/core-technology/liveness/overview.md) dan [Pencocokan Wajah](https://docs.didit.me/id/core-technology/face-match/overview.md) 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](https://docs.didit.me/id/console/id-verification-methods.md#aktifkan-smart-id-atau-mobile-id) untuk jalur konsol selengkapnya.

> [!WARNING]
>
> 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.

```json theme={null}
{
  "EST": {
    "document": { "enabled": true },
    "wallet": {
      "enabled": true,
      "providers": ["smart_id", "mobile_id"],
      "on_failure": "fallback_to_document"
    }
  }
}
```

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](https://docs.didit.me/id/management-api/workflows/feature-configs.md#ocr-/-verifikasi-identitas).

## Membaca hasil yang diverifikasi

Baca sesi yang telah selesai melalui [API keputusan sesi](https://docs.didit.me/id/sessions-api/retrieve-session.md) atau [integrasi webhook](https://docs.didit.me/id/integration/webhooks.md) 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](https://docs.didit.me/id/reference/data-models.md#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](https://docs.didit.me/id/getting-started/pricing.md).
Lihat [tabel harga dompet](https://docs.didit.me/id/core-technology/id-verification/digital-id-wallets.md#harga) 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](https://docs.didit.me/id/core-technology/id-verification/digital-id-wallets.md) 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](https://docs.didit.me/id/core-technology/id-verification/finnish-trust-network.md).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.