Smart-ID API: panduan pengembang untuk RP API v3

Terakhir ditinjau: 5 Oktober 2026 · Bukan nasihat hukum

Ini adalah panduan berbasis kode untuk Smart-ID API: endpoint, sesi, pemeriksaan respons, pengujian demo, dan kedudukan hukum. Untuk kontrak dan aturan AML per negara, baca panduan integrasi Smart-ID kami.

Sekilas tentang Smart-ID

Smart-ID adalah aplikasi seluler dari SK ID Solutions AS. Melalui Relying Party API milik SK, layanan menggunakannya untuk memproses login pengguna atau mengumpulkan tanda tangan.^[13] Sebagian dari setiap kunci disimpan di server SK, yang oleh Otoritas Sistem Informasi Estonia (RIA) disebut "layanan server manajemen kunci Smart-ID".^[4]

Adopsi: pengguna dan transaksi

Lituania adalah pasar Smart-ID terbesar dengan 1,857,471 pengguna, diikuti Latvia dengan 1,198,463 dan Estonia dengan 797,395, menurut penghitung langsung di smart-id.com pada 5 Oktober 2026.^[1] SK melaporkan "hampir 100 juta transaksi setiap bulan".^[2]

Di Estonia, Smart-ID memiliki "pangsa pasar hampir 60 persen" dari autentikasi, menurut ERR News. Penghitung hanya menampilkan total. Tidak ada sumber primer yang menyebutkan pangsa Smart-ID terhadap penduduk dewasa di setiap negara (5 Oktober 2026).

Yang dilihat pengguna

RP API v3 menjangkau aplikasi melalui tiga cara: kode QR dinamis lintas perangkat, tautan Web2App atau App2App di ponsel yang sama, atau notifikasi push.^[12] SK memasarkan pengalaman QR dan app-to-app sebagai Smart-ID+, yang "tidak lagi bergantung pada pengisian kode identitas pribadi Anda di situs web".^[8]

Cara kerja API v3 Smart-ID

API ini berupa REST melalui HTTPS dengan JSON UTF-8.^[19] Empat kelompok endpoint POST membuka sesi dan mengembalikan sessionID. Satu GET mengembalikan hasilnya.^[13]

Kelompok endpoint RP API v3, dari ikhtisar SK.^[13]

Login lintas perangkat yang disederhanakan dengan tautan perangkat.^[12][18]

Hal yang perlu diwaspadai:

• Setiap permintaan awal v3 membawa rpChallenge acak yang Anda buat. Parameter ini menggantikan nonce v2 untuk mencegah serangan replay.^[20]
• sessionSecret tidak boleh sampai ke frontend Anda, dan satu alur hanya mendapat satu permintaan sesi, bahkan ketika Anda menampilkan QR dan tautan bersamaan.^[18]
• Dalam alur notifikasi, Anda menghitung kode empat digit dari SHA-256 atas rpChallenge.^[17]
• SK mengautentikasi Anda berdasarkan IP sumber ditambah relyingPartyUUID, dan mewajibkan HTTPS key pinning.^[19]
• Dokumentasi SK menyebutkan bahwa pengguna tanpa akun akan menerima HTTP 404, dan meminta Anda menampilkan satu pesan untuk semua kasus error, untuk mencegah enumerasi.^[19]

Apa yang diterima bisnis dari Smart-ID API

Sesi yang selesai mengembalikan state, result.endResult, sertifikat pengguna di cert, dan objek signature. serialNumber milik subjek berisi kode identitas, misalnya PNOEE-30001010004, dengan awalan yang menunjukkan negara.^[15]

Verifikasi respons SK mengharuskan Anda untuk:^[15]

• Memeriksa bahwa state bernilai COMPLETE, endResult bernilai OK, dan protokolnya ACSP_V2 (login) atau RAW_DIGEST_SIGNATURE.
• Memvalidasi rantai sertifikat hanya terhadap CA milik SK, dengan OCSP atau CRL.
• Mewajibkan setiap pengenal kebijakan Smart-ID, sehingga sertifikat SK lainnya gagal.
• Membandingkan certificateLevel dengan tingkat yang Anda syaratkan.
• Menyusun ulang payload yang ditandatangani dan memverifikasi tanda tangannya.
• Memverifikasi nilai URL callback dalam alur pada perangkat yang sama.

Tingkat jaminan dan kedudukan hukum

Smart-ID tidak termasuk dalam daftar skema eID yang dinotifikasi di UE; skema Estonia yang dinotifikasi (tingkat High, 7 November 2018) mencakup kartu identitas dan Mobile-ID.^[6]

Catatan: e-resident "tidak dapat dibedakan dari penduduk".^[5]

Uji tuntas nasabah AML Estonia

Undang-Undang Pencegahan Pencucian Uang dan Pendanaan Terorisme Estonia (RahaPTS) menetapkan jalur jarak jauh dalam § 31(3).^[23]

§ 31(3)RahaPTS (Estonia)

"1) e-identimise süsteemi, millest on teatatud ... (EL) nr 910/2014 ... artikli 9 kohaselt ja mis vastab ... artikli 8 lõike 2 punktis b või c sätestatud usaldusväärsuse tasemele" atau "2) kvalifitseeritud usaldusteenust"

Sumber: Riigi Teataja, RahaPTS^[23]

Artinya: skema eID yang telah dinotifikasi pada tingkat substansial atau tinggi, atau layanan kepercayaan berkualifikasi. Jalur 1 tidak sesuai. Per 5 Oktober 2026 belum ada pernyataan resmi apakah sertifikat berkualifikasi Smart-ID memenuhi jalur 2, jadi tanyakan kepada Finantsinspektsioon atau penasihat hukum. Undang-undang AML Lituania (Pasal 11) dan Peraturan Kabinet Latvia No. 392 (p. 7.1) mencantumkan tanda tangan elektronik berkualifikasi atau aman sebagai salah satu dari beberapa jalur jarak jauh.^[28][29]

Mulai 2027: Pasal 22(6) AMLR

Anti-Money Laundering Regulation (AMLR) berlaku mulai 10 Juli 2027. Pasal 22(6)(b) menerima "sarana identifikasi elektronik yang memenuhi persyaratan Regulation (EU) No 910/2014 terkait tingkat jaminan 'substansial' atau 'tinggi' serta layanan kepercayaan berkualifikasi yang relevan".^[30] Rancangan akhir standar Anti-Money Laundering Authority (AMLA) tertanggal 30 September 2026, yang belum menjadi hukum, menerima eID pada tingkat substansial atau tinggi "terlepas dari apakah eID tersebut dinotifikasi berdasarkan Pasal 9".^[31] Halaman dompet EUDI kami membahas linimasa eIDAS 2.

Cara bisnis terhubung: kontrak RP langsung atau melalui broker

Proses SK: uji coba gratis tanpa perjanjian, pilih langkah keamanan, kirim alamat IP dan nama layanan Anda, tanda tangani, terima RP UUID Anda, lalu mulai beroperasi "dalam beberapa hari sejak pertanyaan pertama Anda".^[21] Broker bersertifikat juga menjual kembali Smart-ID, dan badan publik Estonia dapat menggunakan gateway TARA milik RIA.^[5]

Tiga cara mengakses Smart-ID.^[21][5]

Daftar harga SK (mulai 1 Juni 2026) menagih setiap "permintaan autentikasi atau penandatanganan Smart-ID": €0.109 dengan minimum bulanan €60, turun hingga €0.0106 pada paket 3 juta, dan perjanjian tersendiri di atas 5 juta.^[11] SK menyatakan bahwa Smart-ID+ "tidak dikenakan biaya tambahan" bagi RP yang sudah ada.^[7]

Pengujian di lingkungan demo

Demo: https://sid.demo.sk.ee/smart-id-rp/v3/, relyingPartyUUID 00000000-0000-4000-8000-000000000000, nama DEMO. Live: https://rp-api.smart-id.com/v3/.^[14] Akun uji berdasarkan hasil:^[16]

Kasus penggunaan dan aturan sektor

• Onboarding KYC dan AML. Nama dan kode pribadi yang ditandatangani; kesesuaian untuk AML berbeda di tiap negara.^[23][28][29]
• Perjudian dan usia. Undang-Undang Perjudian Estonia melarang orang di bawah 21 tahun mengikuti permainan untung-untungan (§ 34(2)) dan mewajibkan operator jarak jauh memverifikasi setiap pemain serta mendaftarkan kode pribadinya (§ 53(1)).^[24] Kami tidak menemukan klaim khusus usia di API.
• Penandatanganan. Akun berkualifikasi menandatangani melalui v3/signature; "4 dari 10 warga Lituania menggunakan tanda tangan elektronik berkualifikasi pada 2025".^[13][33]
• Telekomunikasi. Tidak ada aturan Baltik yang menyebut Smart-ID untuk registrasi kartu SIM (5 Oktober 2026).

Batasan dan alternatif cadangan

"Di Estonia dan Latvia, Smart-ID saat ini terbatas bagi orang yang memiliki nomor ID nasional Estonia atau Latvia"; nonresiden Lituania dapat memperoleh Smart-ID Basic di dua bank.^[22] Smart-ID tidak memiliki batas usia, tetapi jalur registrasinya memiliki batas (kartu identitas Latvia mulai usia 14), dan akun di bawah 18 tahun memerlukan otorisasi orang tua.^[32]

Kami tidak menemukan gangguan layanan yang terdokumentasi per 5 Oktober 2026; risikonya adalah phishing. Hampir €23 juta dicuri dari rekening bank di Estonia pada 2025 melalui penipuan PIN, menurut ERR News. Sejak 29 April 2026, registrasi di Estonia membaca kartu identitas melalui NFC, bukan dengan pembaca kartu.^[34]

eID lebih dulu, dokumen sebagai cadangan; catat alasan setiap cadangan diperlukan.^[31]

Daftar periksa implementasi API Smart-ID

Bangun lebih dulu di demo gratis SK, sehingga kontrak menunggu sampai kode Anda berfungsi.^[21] Verifikasi respons adalah inti pekerjaannya.^[15]

• Bangun dengan URL demo dan akun uji yang dipublikasikan.^[14][16]
• Utamakan alur tautan perangkat; izinkan notifikasi hanya pada perangkat yang dikenal.^[13]
• Buat rpChallenge acak yang baru untuk setiap login.^[20]
• Pin kunci HTTPS SK dan simpan sessionSecret di server.^[19][18]
• Jalankan setiap langkah verifikasi respons SK.^[15]
• Kirimkan IP dan nama layanan Anda kepada SK, lalu tanda tangani kontrak.^[21]
• Catat dasar hukum Anda untuk penggunaan AML di setiap negara.^[23]
• Tambahkan jalur dokumen untuk pengguna yang tidak memiliki Smart-ID.

Cara Didit membantu dengan Smart-ID

Smart-ID sudah aktif di Didit untuk verifikasi eID di Estonia, Latvia, Lituania, dan Belgia. Didit memegang koneksi SK, jadi Anda tidak perlu kontrak RP, daftar IP yang diizinkan, maupun kode sertifikat.

Di konsol, buka Workflows, langkah ID Verification, Countries, pilih negara, lalu centang Smart-ID di bawah "Wallets accepted". Melalui API, atur methods.EST.wallet, buat sesi, lalu baca GET /v3/session/{id}/decision/ atau webhook: verification_method bernilai "wallet" dengan objek wallet_verification, sesuai dokumentasi dompet ID digital.^[35] Pengguna menyetujui kode pembanding di aplikasi Smart-ID. Didit tidak pernah meminta PIN.

Anda mendapatkan nama lengkap, tanggal lahir, kode pribadi Baltik, tingkat jaminan (berlabel High) dan pemeriksaan tanda tangan. Tidak ada alamat, tidak ada foto wajah. Pengguna tanpa Smart-ID beralih ke verifikasi dokumen dengan pembacaan chip NFC ($0.15), deteksi liveness dan pencocokan wajah. KYC lengkap seharga $0.33 dan penyaringan AML $0.20. Hanya proses masuk eID yang selesai yang ditagih. Satu verifikasi Smart-ID yang selesai dikenai biaya $0.20 (halaman harga). Semua eID tercantum di halaman dompet identitas digital.

Pertanyaan yang sering diajukan

Sumber

1. Halaman utama Smart-ID, penghitung pengguna langsung, SK ID Solutions, dibaca 5 Oktober 2026.
2. 2025: memajukan kepercayaan digital melampaui batas negara, SK ID Solutions, 19 Januari 2026.
3. Kepercayaan dan persaingan dalam identitas digital di Eropa, e-Estonia, 2026.
4. Identitas elektronik (eID), Information System Authority (RIA).
5. Spesifikasi teknis TARA, RIA.
6. Ikhtisar skema eID yang telah dinotifikasi awal dan dinotifikasi berdasarkan eIDAS, Komisi Eropa, dibaca 5 Oktober 2026.
7. Smart-ID+, SK ID Solutions.
8. Bagaimana Smart-ID yang baru melindungi saya dari penipuan, FAQ Smart-ID.
9. Pemerintah Estonia mengadopsi Smart-ID+ untuk memperkuat keamanan, SK ID Solutions, 28 Januari 2026.
10. Mengapa terkadang saya melihat satu kode konfirmasi dan terkadang tiga, FAQ Smart-ID.
11. Daftar harga, SK ID Solutions, berlaku mulai 1 Juni 2026.
12. Relying Party API: pengantar, SK ID Solutions, versi 3.2.3.
13. Relying Party API: ikhtisar endpoint API, SK ID Solutions.
14. Parameter teknis lingkungan, SK ID Solutions.
15. Relying Party API: verifikasi respons, SK ID Solutions.
16. Akun uji untuk pengujian otomatis, SK ID Solutions.
17. Relying Party API: alur berbasis notifikasi, SK ID Solutions.
18. Relying Party API: alur device link, SK ID Solutions.
19. Relying Party API: deskripsi teknis API, SK ID Solutions.
20. Relying Party API: catatan perubahan, SK ID Solutions.
21. Proses integrasi bagi penyedia layanan elektronik, Smart-ID.
22. Dapatkah warga negara asing dan non-residen menggunakan Smart-ID, FAQ Smart-ID.
23. Rahapesu ja terrorismi rahastamise tõkestamise seadus (RahaPTS), § 31, Riigi Teataja.
24. Hasartmänguseadus (Undang-Undang Perjudian), Riigi Teataja.
25. Elektroniskā identifikācija, Kementerian Pertahanan Latvia.
26. Smart-ID memperoleh status qualified lokal untuk autentikasi di Latvia, SK ID Solutions, 29 Mei 2023.
27. Smart-ID dan Mobile-ID diakui sebagai sarana yang disetujui negara di Lituania, SK ID Solutions, 19 Desember 2024.
28. Undang-Undang tentang Pencegahan Pencucian Uang dan Pendanaan Terorisme, Pasal 11, Lituania, teks konsolidasi INFOLEX.
29. Peraturan Kabinet No. 392, Latvia, likumi.lv.
30. Regulation (EU) 2024/1624 (AMLR), EUR-Lex, Jurnal Resmi tanggal 19 Juni 2024.
31. Laporan Akhir, rancangan RTS berdasarkan Pasal 28(1) AMLR, AMLA, 30 September 2026.
32. Batasan usia untuk menggunakan Smart-ID, FAQ Smart-ID.
33. SK ID Solutions menerbitkan hampir tiga juta sertifikat di Lituania pada 2025, SK ID Solutions, 7 Mei 2026.
34. Pendaftaran Smart-ID dengan kartu identitas Estonia kini tersedia melalui NFC, Smart-ID, 29 April 2026.
35. Dompet identitas digital, dokumentasi Didit.
36. Relying Party API: interaksi, SK ID Solutions.

Smart-ID adalah salah satu dari lima eID yang sudah aktif di layanan verifikasi eID Didit. Lihat juga apa itu verifikasi eID dan panduan API BankID Swedia.