API BankID di Swedia: relying party langsung atau broker, panduan lengkap
Cara bisnis terhubung ke API BankID di Swedia: langsung melalui bank atau lewat broker, data yang dikembalikan saat masuk, kedudukan hukumnya untuk AML dan perjudian, batasan, serta cadangan berupa dokumen.

Ringkasnya
API BankID memungkinkan bisnis mengidentifikasi pengguna Swedia, atau mengumpulkan tanda tangan, melalui aplikasi BankID. Sebanyak 8.7 juta orang menggunakan BankID pada 2025.[1] Anda dapat mengakses API ini dengan salah satu dari dua cara: membeli layanan dari bank dan mengintegrasikannya sebagai relying party langsung, atau melalui penjual kembali yang sudah melakukan integrasi tersebut.[4]
- Proses masuk mengembalikan personnummer 12 digit dan nama, dalam bentuk yang ditandatangani. Tidak ada alamat, tidak ada foto wajah.[6]
- BankID berada di dalam skema eID Swedia (dinotifikasi pada tingkat Substantial dan High), dan DIGG mencantumkan BankID pada tingkat Substantial. Harga tidak dipublikasikan.[4][10][11]
BankID adalah identifikasi elektronik (eID) Swedia: aplikasi swasta yang diterbitkan oleh bank-bank berdasarkan aturan bersama[3] dan disetujui oleh badan digital negara, DIGG.[11] Bagi bisnis, ini adalah cara standar untuk mengetahui siapa pelanggan Swedia, dengan jawaban yang ditandatangani, bukan foto kartu.
BankID Sweden secara ringkas
BankID Sweden
Identifikasi elektronik Swedia yang diterbitkan oleh bank
Berapa banyak orang yang menggunakan BankID
Sumber: BankID in numbers, angka untuk 2025.[1]
Penggunaan tumbuh dari 4.1 miliar transaksi pada 2019 menjadi 7.9 miliar pada 2025.[1]
| Sektor | Porsi penggunaan BankID, 2025 |
|---|---|
| Perbankan dan keuangan | 50% |
| Layanan swasta lainnya | 27% |
| Pembayaran seluler | 17% |
| Sektor publik | 6% |
BankID in numbers.[1]
- September 2002DidirikanFinansiell ID-Teknik BID didirikan.
- Juni 2011Aplikasi selulerMobile BankID diluncurkan.
- 14 Desember 2020DinotifikasiSkema eID Swedia, termasuk BankID, dinotifikasi berdasarkan eIDAS.
- 17 Agustus 2026Pemeriksaan wajahVerifikasi tambahan (step-up) dengan pengenalan wajah mulai tersedia.
- 1 Desember 2026SverigeIDe-ID negara mulai tersedia berdampingan dengan BankID.
Dari pendirian perusahaan hingga e-ID negara.[2][10][7][17]
Yang dilihat pengguna
Di ponsel, aplikasi BankID terbuka di perangkat yang sama. Di komputer, pengguna memindai kode QR dengan aplikasi tersebut.[6] Menurut riset tentang alur BankID, pengguna kemudian mengonfirmasi dengan kode keamanan atau biometrik. Referensi collect BankID mengonfirmasi kode tersebut melalui kode kesalahannya.[6]
Pilih cara verifikasi
Masuk dengan identitas elektronik yang sudah Anda gunakan.
BankID
Gunakan dokumen identitas sebagai gantinya
1Pengguna memilih BankID dalam proses pendaftaran Anda.
Di komputer: pindai dengan BankID
Buka aplikasi BankID di ponsel Anda dan pindai kode ini.
2Khusus komputer: kode QR meneruskan permintaan ke ponsel. Di ponsel, layar ini dilewati.[6]
Identifikasi diri Anda
Periksa siapa yang meminta, lalu masukkan kode keamanan Anda.
3Pengguna mengonfirmasi di aplikasi (kode keamanan atau biometrik, menurut riset tentang alur BankID).[6]
Pemeriksaan tambahan
Tempelkan paspor atau kartu identitas Anda, atau ambil swafoto.
4Verifikasi tambahan (step-up) opsional yang dapat diminta oleh layanan.[7]
Anda telah terverifikasi
- NamaDibagikan
- PersonnummerDibagikan
- AlamatTidak dibagikan
- Foto wajahTidak dibagikan
5Kembali ke layanan Anda dengan hasil yang ditandatangani.[6]
Layar 4 bersifat opsional: pemindaian NFC pada paspor atau kartu identitas, atau, sejak 17 Agustus 2026, pengenalan wajah terhadap foto di chip paspor atau kartu identitas Swedia.[6][7] SIM tidak memiliki chip, sehingga tidak dapat digunakan untuk langkah verifikasi tambahan ini.[7]
Video menyusul: flow-qr-cross-device
Proses masuk lintas perangkat dengan kode QR, dari awal sampai akhir.
Apa yang dikembalikan API BankID kepada bisnis
Backend Anda memulai order dengan /auth (identifikasi) atau /sign, lalu memanggil /collect setiap dua detik selama order masih tertunda.[6] Setelah pengguna mengonfirmasi, respons memuat completionData.
Pengguna mengonfirmasi di aplikasi BankID
Integrasi langsung BankID, disederhanakan. Kode petunjuk memberi tahu apa yang perlu Anda tampilkan kepada pengguna.[6]
| Bidang | Kapan | Keterangan |
|---|---|---|
| personalNumber | Selalu | Nomor identitas nasional Swedia, 12 digit |
| name, givenName, surname | Selalu | Nama lengkap dan bagian-bagiannya |
| signature | Selalu | Tanda tangan XML yang dienkode Base 64 |
| ocspResponse | Selalu | Status sertifikat yang ditandatangani untuk tanda tangan tersebut |
| device.ipAddress, device.uhi | Dikembalikan | IP yang terlihat oleh BankID, pengenal unik perangkat keras |
| bankIdIssueDate | Dikembalikan | Tanggal BankID diterbitkan |
| stepUp.mrtd, stepUp.face | Jika step-up dijalankan | Apakah pemeriksaan chip atau wajah telah dilakukan |
| risk | Hanya jika diminta | low, moderate, atau high |
| Alamat, kewarganegaraan, foto wajah | Tidak pernah | Bukan bagian dari respons |
Respons collect untuk order yang telah selesai.[6]
Tanggal lahir dienkode dalam personnummer, sehingga pemeriksaan usia selalu tersedia pada setiap login.[3]
Tingkat jaminan dan kedudukan hukum
Swedia menotifikasi satu skema payung berdasarkan eIDAS, "Swedish eID", pada 14 Desember 2020, dengan mencantumkan BankID, Freja eID dan EFOS sebagai sarananya pada tingkat Substantial dan High.[10] Tabel e-ID Swedia yang dinotifikasi milik DIGG sendiri menempatkan Mobile BankID, BankID on file dan BankID on card pada tingkat Substantial.[11] Dalam kerangka kepercayaan Swedia, BankID berada pada tingkat kepercayaan 3.[3][11]
| Instrumen | Artinya bagi BankID |
|---|---|
| Kerangka kepercayaan DIGG untuk e-ID Swedia | BankID disetujui pada tingkat kepercayaan 3, bersama e-ID lain yang dicantumkan DIGG pada tingkat tersebut[11] |
| eIDAS, Regulation (EU) No 910/2014 | Dinotifikasi dalam skema eID Swedia; BankID menyatakan bahwa tanda tangan BankID adalah tanda tangan elektronik lanjutan[3][10] |
| PSD2 | Identifikasi memenuhi autentikasi pelanggan yang kuat. Tanda tangan memenuhi penautan dinamis (dynamic linking)[3] |
| Lag (2017:630), bab 3, bagian 7 | Sarana eID eIDAS boleh digunakan untuk memverifikasi identitas dalam pemeriksaan anti pencucian uang[13] |
| Spellagen (2018:1138), bab 12, bagian 2 | Pemegang izin perjudian wajib memeriksa identitas melalui identifikasi elektronik yang andal[14] |
| Kitab Undang-Undang Hukum Pidana, bab 15, bagian 12 | Menggunakan BankID milik orang lain merupakan penyalahgunaan dokumen[3] |
| Lag (2026:1358) | Undang-undang e-ID negara, berlaku mulai 1 Desember 2026[12] |
Untuk uji tuntas nasabah, undang-undang anti pencucian uang Swedia menyatakan:
Bab 3, bagian 7Lag (2017:630) om åtgärder mot penningtvätt och finansiering av terrorism
"När första stycket tillämpas får man använda medel för elektronisk identifiering och betrodda tjänster enligt ... (EU) nr 910/2014"
Sumber: Sveriges riksdag, SFS 2017:630[13]
Artinya: sarana eID eIDAS boleh digunakan untuk memverifikasi identitas. Uji tuntas secara keseluruhan tetap berbasis risiko.
Mulai 10 Juli 2027, Peraturan Anti Pencucian Uang Uni Eropa (AMLR) berlaku. Pasal 22(6)(b) peraturan tersebut menerima sarana eID pada "tingkat jaminan 'substantial' atau 'high'", sehingga BankID memenuhi syarat.[15] Rancangan akhir standar dari otoritas anti pencucian uang Uni Eropa (AMLA) telah dikirim ke Komisi pada 30 September 2026 dan belum berlaku sebagai hukum. Menurut rancangan tersebut, sarana eID "sebaiknya digunakan sedapat mungkin" dan pemeriksaan dokumen jarak jauh menjadi cadangan bagi pelanggan yang tidak dapat menggunakannya. Rancangan itu memasukkan Dompet Identitas Digital Uni Eropa (EUDI Wallet) sebagai salah satu sarana tersebut.[16]
Catatan
SverigeID, e-ID negara yang diterbitkan oleh Otoritas Kepolisian Swedia, mulai tersedia pada 1 Desember 2026. DIGG telah menyetujuinya pada tingkat kepercayaan Swedia 4, tingkat tertinggi. Per 5 Oktober 2026, SverigeID belum masuk daftar skema yang dinotifikasi di Uni Eropa. SverigeID melengkapi BankID dan Freja eID, bukan menggantikannya.[11][17]
Cara terhubung ke API BankID Sweden: langsung atau melalui broker
Jawaban BankID: "Anda dapat membeli layanan BankID dari bank atau melalui pengecer."[4]
Relying party langsung
Beli dari bank, bangun sendiri
- Buat kontrak dengan bank yang menjual BankID
- Pesan sertifikat pihak pengandal (FP) melalui BankID Keygen
- Bangun penanganan start, QR, collect, pesan pengguna, dan cancel
- Harga per identifikasi dan tanda tangan, disepakati dengan bank
Paling cocok untuk layanan satu negara dengan tim internal
Melalui broker atau penjual kembali
Satu kontrak, satu integrasi
- Kontrak dengan penjual kembali, yang membeli layanan BankID
- Anda memanggil API reseller, bukan API BankID
- Integrasi milik reseller, bukan milik Anda, yang terhubung ke BankID
- Harga per pemeriksaan, ditetapkan oleh reseller
Paling cocok untuk onboarding multinegara
Kedua jalur berjalan di bawah aturan BankID yang sama.[4]
Harga tidak dipublikasikan di kedua jalur. Biaya "umumnya didasarkan pada jumlah identifikasi dan tanda tangan yang dilakukan", dan harga di sektor swasta ditentukan oleh persaingan.[4] Waktu tunggu onboarding juga tidak dipublikasikan, per 5 Oktober 2026.
Beberapa aturan mengikat Anda di kedua jalur. Aturan kontrak BankID melarang "pengalihan ID" (ID switching), yaitu menggunakan proses masuk untuk menerbitkan kata sandi atau kredensial lain, atau mempertahankan sesi login pengguna melalui cookie setelah dua jam tanpa aktivitas.[4] Kode petunjuk (hint code) baru dapat muncul "tanpa pemberitahuan sebelumnya", dan integrasi langsung harus dapat menangani kode petunjuk yang tidak dikenal.[6]
Badan publik membayar harga tetap melalui sistem otorisasi DIGG. Perusahaan swasta hanya dapat bergabung dengan node eIDAS milik DIGG.[4][12] Sisi komersialnya dibahas dalam BankID untuk bisnis di Swedia.
Kasus penggunaan API BankID
| Kasus penggunaan | Yang diberikan BankID kepada Anda | Aturan yang mendasarinya |
|---|---|---|
| Onboarding KYC dan AML | Identitas terverifikasi dari eID yang telah dinotifikasi | Lag (2017:630) bab 3 pasal 7[13] |
| Perjudian daring | Identifikasi elektronik yang andal saat pendaftaran | Spellagen bab 12 pasal 2[14] |
| Pemeriksaan usia | Tanggal lahir dari personnummer | Respons collect[6] |
| Pembayaran | Autentikasi pelanggan yang kuat dan dynamic linking | PSD2[3] |
| Kontrak dan kredit | Tanda tangan elektronik lanjutan | eIDAS, Regulasi (EU) No 910/2014[3] |
Perjudian menambahkan dua aturan: pendaftaran daring terbatas bagi penduduk Swedia, dan lisensi tidak boleh mencakup orang di bawah usia 18 tahun.[14]
Batasan dan alternatif cadangan
BankID memerlukan personnummer Swedia dan bank penerbit.[5]
- Anak di bawah umur: bank menetapkan batas usia, "paling umum ... 13 atau 18 tahun", dan anak di bawah umur memerlukan persetujuan orang tua.[5]
- Warga Swedia di luar negeri dapat kehilangan kelayakan ketika mereka dihapus dari register SPAR.[5]
- Warga negara asing: daftar berita BankID mengumumkan perpanjangan dengan paspor UE bagi warga negara non-Swedia yang terdaftar sejak 5 Mei 2026. Pengunjung dan nonpenduduk tanpa personnummer tidak dapat memperolehnya.[5][9]
Menurut Computer Sweden, polisi melaporkan penurunan 90% penipuan telepon terkait login BankID setelah kode QR diperkenalkan. Pada 2026 BankID menambahkan peringatan pembayaran dan step-up wajah.[9]
Bagi pengguna lainnya, alternatifnya adalah pemeriksaan dokumen: baca chip paspor atau kartu identitas melalui NFC (lihat verifikasi eID NFC dan keamanan chip), periksa liveness, lalu cocokkan wajah.
1Tawarkan BankID terlebih dahulu kepada pengguna Swedia
Aplikasi di perangkat yang sama atau QR di komputer.
Pengguna menyelesaikan order BankID
Terima hasil yang ditandatangani
Personnummer, nama, tanda tangan, OCSP.
Verifikasi dengan dokumen
Pembacaan chip NFC, liveness, dan pencocokan wajah.
2Tambahkan alamat dari sumber lain
BankID tidak mengembalikannya.
3Lakukan screening dan ambil keputusan
Pemeriksaan sanksi dan PEP. Keputusan tetap ada pada Anda.
eID terlebih dahulu, dokumen sebagai alternatif, satu keputusan di akhir.
Daftar periksa integrasi BankID
- Tentukan antara kontrak langsung dengan bank atau melalui reseller.
- Daftarkan atribut yang dibutuhkan kebijakan Anda dan sumber alamatnya.
- Dukung peluncuran di perangkat yang sama dan kode QR di desktop.
- Lakukan polling collect setiap dua detik dan hentikan saat failed.[6]
- Petakan setiap kode petunjuk ke pesan pengguna, termasuk yang tidak dikenal.[6]
- Tentukan penggunaan indikator risiko dan step-up.
- Simpan tanda tangan dan respons OCSP untuk audit.[6]
- Akhiri sesi yang tidak aktif sesuai aturan dua jam.[4]
- Bangun alternatif dokumen untuk pengguna tanpa BankID.
- Lakukan pengujian di lingkungan uji BankID sebelum Anda go live.
Bagaimana Didit membantu verifikasi BankID Sweden
BankID Sweden sudah aktif di Didit. Pengguna memilih BankID di alur yang di-hosting atau di SDK, lalu masuk di ponsel yang sama atau melalui kode QR. Didit tidak pernah meminta kode keamanan BankID (PIN).
Aktifkan di konsol pada Workflows, ID Verification, Countries, Wallets accepted, atau melalui API workflows. Satu proses masuk mengembalikan nama lengkap, tanggal lahir, personnummer Swedia, tingkat jaminan (berlabel Substantial) dan pemeriksaan tanda tangan (berupa hasil penilaian, bukan tanda tangan mentah). Tidak ada alamat, tidak ada foto wajah. Pengguna tanpa BankID beralih ke pengambilan dokumen dengan pembacaan chip NFC, liveness dan pencocokan wajah dalam workflow yang sama. Pemeriksaan KYC lengkap berbiaya $0.33, verifikasi NFC $0.15 dan penyaringan AML $0.20.
Hanya proses masuk BankID yang selesai yang dikenai biaya. Proses yang dibatalkan, melewati batas waktu, dan gagal tidak dikenai biaya. Pemeriksaan dokumen dikenai biaya per pemeriksaan. Biaya BankID adalah $0.20 (harga). eID yang sudah aktif tercantum di halaman dompet identitas digital.
Tangkapan layar menyusul: hosted-flow-wallet-chooser
Pengguna memilih BankID di alur Didit.
Tangkapan layar menyusul: hosted-flow-qr
Di komputer, kode QR mengalihkan proses masuk ke ponsel.
Tangkapan layar menyusul: console-wallets-accepted
Mengaktifkan BankID Sweden di konsol Didit.
Disediakan oleh Didit
- Masuk dengan BankID Sweden di alur yang di-hosting atau di SDK
- Jalur dokumen untuk pengguna tanpa BankID
- Atribut yang ditandatangani dan bukti setiap pemeriksaan
Tetap menjadi tanggung jawab Anda
- Penilaian risiko dan kebijakan
- Keputusan onboarding
- Sumber alamat nasabah
Terima BankID Sweden dalam proses pendaftaran Anda mulai hari ini
Aktifkan BankID dan jalur dokumen dalam satu workflow, dan bayar hanya untuk proses masuk eID yang selesai.
Poin utama
- 8.7 juta orang menggunakan BankID pada 2025, dan 99.9% warga Swedia terdaftar berusia 18 hingga 67 tahun memilikinya.
- Anda membeli BankID dari bank dan mengintegrasikannya sendiri, atau melalui reseller; harganya tidak dipublikasikan.
- Satu proses masuk mengembalikan personnummer dan nama, dalam bentuk yang ditandatangani, tetapi tanpa alamat dan tanpa foto wajah.
- DIGG mencantumkan BankID pada tingkat Substantial, yang memenuhi Pasal 22(6)(b) AMLR mulai 10 Juli 2027.
Pertanyaan yang sering diajukan
Berapa biaya API BankID?
BankID tidak memublikasikan harganya. Biayanya biasanya didasarkan pada jumlah identifikasi dan tanda tangan, dan harga untuk sektor swasta ditentukan oleh persaingan.[4] Didit mengenakan biaya $0.20.
Data apa yang dikembalikan BankID?
Personnummer 12 digit, nama lengkap, nama depan dan nama belakang, tanda tangan dan respons OCSP, ditambah data perangkat dan tingkat risiko opsional. Tidak ada alamat, kewarganegaraan, atau foto wajah.[6]
Bisakah BankID memeriksa usia pengguna?
Ya. Personnummer memuat tanggal lahir, sehingga setiap proses masuk memberi tahu Anda usia pengguna. BankID sendiri hanya tersedia bagi anak di bawah umur jika bank mereka mengizinkannya, biasanya mulai usia 13 atau 18 tahun dan dengan persetujuan orang tua.[5][6]
Bisakah warga negara asing menggunakan BankID?
Hanya dengan personnummer Swedia dan rekening di bank penerbit. Daftar berita BankID mengumumkan perpanjangan dengan paspor UE bagi warga negara non-Swedia yang terdaftar sejak 5 Mei 2026. Pengunjung tanpa personnummer memerlukan jalur lain, seperti pemeriksaan dokumen.[5][9]
Apa tingkat jaminan BankID?
Substantial. BankID merupakan bagian dari skema eID Swedia yang dinotifikasi berdasarkan eIDAS pada 14 Desember 2020; skema tersebut dinotifikasi pada tingkat Substantial dan High, dan DIGG mencantumkan sarana BankID pada tingkat Substantial dan pada tingkat kepercayaan Swedia 3.[10][11]
Apakah BankID cukup untuk uji tuntas nasabah AML di Swedia?
BankID merupakan sarana yang diterima. Undang-undang anti pencucian uang, bab 3, pasal 7, memperbolehkan Anda menggunakan identifikasi elektronik eIDAS untuk memverifikasi identitas. Penyaringan, penilaian risiko, dan pemantauan tetap diwajibkan sebagai tambahan.[13]
Berapa lama integrasi BankID?
BankID tidak memublikasikan waktu tunggu onboarding, per 5 Oktober 2026. Integrasi langsung memerlukan kontrak dengan bank, sertifikat relying party dari BankID Keygen, serta penanganan QR, polling, dan hint code milik Anda sendiri; reseller menggantikan semua itu dengan satu API.[4][6]
Bisakah saya menguji BankID sebelum beroperasi?
Ya. Situs pengembang BankID memiliki portal uji di samping referensi API.[6] Untuk beroperasi tetap diperlukan kontrak dengan bank atau reseller dan, pada jalur langsung, sertifikat relying party yang dipesan melalui BankID Keygen.[4] Uji juga penanganan Anda terhadap hint code yang tidak dikenal, karena BankID dapat menambahkan kode baru tanpa pemberitahuan sebelumnya.[6]
Apakah SverigeID menggantikan BankID?
Tidak. SverigeID, e-ID negara yang mulai tersedia pada 1 Desember 2026, merupakan pelengkap BankID dan Freja. SverigeID disetujui pada tingkat kepercayaan Swedia 4 tetapi belum masuk daftar skema yang dinotifikasi di UE, per 5 Oktober 2026.[11][17]
Sumber
- BankID in numbers, BankID, data tahun 2025.
- Sejarah, BankID.
- Undang-undang dan peraturan, BankID.
- Hubungkan bisnis Anda, BankID.
- Dapatkan BankID, BankID.
- Referensi API /collect, BankID Developers, dibaca 5 Oktober 2026.
- Pengenalan wajah sebagai kontrol tambahan, berita BankID, Agustus 2026.
- Kartu identitas digital di tempat pemungutan suara, berita BankID, 2026.
- Berita, BankID, entri 2026.
- Ikhtisar skema eID yang telah pra-notifikasi dan dinotifikasi berdasarkan eIDAS, Komisi Eropa, dibaca 5 Oktober 2026.
- e-ID dan fungsi atestasi yang disetujui, DIGG.
- Tentang identifikasi elektronik, DIGG.
- Lag (2017:630) om åtgärder mot penningtvätt och finansiering av terrorism, Sveriges riksdag.
- Spellagen (2018:1138), teks undang-undang di lagen.nu.
- Regulation (EU) 2024/1624 (AMLR), Pasal 22, EUR-Lex.
- Laporan Akhir, rancangan RTS berdasarkan Pasal 28(1) AMLR, AMLA, 30 September 2026.
- Statlig e-legitimation, SverigeID, Kepolisian Swedia (Polismyndigheten).
Bandingkan setiap eID nasional di halaman verifikasi eID, atau mulai dengan apa itu verifikasi eID.
Satu alur kerja untuk Swedia dan negara lain
Mulai dengan BankID, tambahkan eID yang sudah dimiliki pengguna Anda, dan tetap gunakan dokumen sebagai cadangan.
Artikel terkait
- e-Devlet untuk bisnis: verifikasi identitas di Turki
- Integrasi Singpass Myinfo: panduan untuk bisnis di Singapura
- Integrasi Cl@ve di Spanyol: siapa yang dapat terhubung dan alternatifnya
- Verifikasi PhilSys: cara bisnis memeriksa National ID
- Panduan verifikator OpenID4VP: menerima EUDI Wallet
- Regulasi eIDAS dijelaskan: apa yang diubah oleh eIDAS 2 (2024/1183)