API de BankID a Suècia: part usuària directa o intermediari, guia completa
Com es connecta una empresa a l'API de BankID a Suècia: directament via un banc o amb un intermediari, què retorna un inici de sessió, la validesa jurídica per a PBC i joc, límits i l'alternativa documental.
En resum
L'API de BankID permet a una empresa identificar un usuari suec, o recollir-ne una signatura, a través de l'app BankID. 8.7 milions de persones van fer servir BankID el 2025.[1] Hi ha dues maneres d'accedir a l'API: contractar el servei a un banc i integrar-lo com a part que hi confia directa, o passar per un revenedor que ja ha fet la integració.[4]
- Un inici de sessió retorna el personnummer de 12 dígits i el nom, signats. Ni adreça ni fotografia.[6]
- BankID forma part del sistema suec d'identificació electrònica (notificat amb nivell substancial i alt), i DIGG inclou BankID amb nivell substancial. Els preus no es publiquen.[4][10][11]
BankID és la identificació electrònica (eID) de Suècia: una app privada emesa pels bancs amb normes comunes[3] i aprovada per l'agència digital de l'Estat, DIGG.[11] Per a una empresa és la manera habitual de saber qui és un client suec, amb una resposta signada en lloc de la foto d'un document.
BankID Sweden d'un cop d'ull
BankID Sweden
La identificació electrònica sueca emesa pels bancs
Quantes persones fan servir BankID
Font: BankID in numbers, xifres del 2025.[1]
L'ús va passar de 4.1 mil milions de transaccions el 2019 a 7.9 mil milions el 2025.[1]
| Sector | Percentatge d'ús de BankID, 2025 |
|---|---|
| Banca i finances | 50% |
| Altres serveis privats | 27% |
| Pagaments mòbils | 17% |
| Sector públic | 6% |
BankID en xifres.[1]
- Setembre de 2002FundacióEs constitueix Finansiell ID-Teknik BID.
- Juny de 2011Aplicació mòbilEs llança Mobile BankID.
- 14 de desembre de 2020NotificatL'esquema suec d'identificació electrònica, amb BankID, es notifica en virtut d'eIDAS.
- 17 d'agost de 2026Verificació facialLa verificació addicional amb reconeixement facial passa a estar disponible.
- 1 de desembre de 2026SverigeIDLa identificació electrònica estatal es posa en marxa al costat de BankID.
De la fundació de l'empresa a la identificació electrònica estatal.[2][10][7][17]
Què veu l'usuari
En un telèfon, l'aplicació BankID s'obre al mateix dispositiu. En un ordinador, l'usuari escaneja un codi QR amb l'aplicació.[6] Segons una anàlisi del flux de BankID, després l'usuari confirma amb un codi de seguretat o amb biometria. La referència de collect de BankID confirma el codi mitjançant els seus codis d'error.[6]
Tria com vols verificar-te
Inicia la sessió amb la identificació electrònica que ja fas servir.
BankID
Fes servir un document d'identitat
1L'usuari tria BankID al teu procés d'alta.
En un ordinador: escaneja amb BankID
Obre l'aplicació BankID al telèfon i escaneja aquest codi.
2Només en ordinador: un codi QR passa l'ordre al telèfon. En un telèfon, aquesta pantalla no apareix.[6]
Identifica't
Comprova qui ho sol·licita i, després, introdueix el teu codi de seguretat.
3L'usuari confirma a l'aplicació (codi de seguretat o biometria, segons una anàlisi del flux de BankID).[6]
Verificació addicional
Acosta el passaport o el document d'identitat, o fes-te una selfie.
4Verificació addicional opcional que el servei pot demanar.[7]
Ja estàs verificat
- NomCompartit
- PersonnummerCompartit
- AdreçaNo compartit
- RetratNo compartit
5Tornada al vostre servei amb el resultat signat.[6]
La pantalla 4 és opcional: una lectura NFC d'un passaport o d'un document d'identitat o, des del 17 d'agost de 2026, el reconeixement facial amb la foto del xip d'un passaport o document d'identitat suec.[6][7] Els permisos de conduir no tenen xip, de manera que no es poden fer servir per a aquest pas de verificació addicional.[7]
Vídeo pendent: flow-qr-cross-device
Un inici de sessió entre dispositius amb un codi QR, de principi a fi.
Què retorna l'API de BankID a una empresa
El vostre backend inicia una ordre amb /auth (identificar) o /sign i, després, crida /collect cada dos segons mentre està pendent.[6] Quan l'usuari confirma, la resposta inclou completionData.
L'usuari confirma a l'app de BankID
Una integració directa amb BankID, simplificada. Els codis d'indicació us diuen què heu de mostrar a l'usuari.[6]
| Camp | Quan | Què és |
|---|---|---|
| personalNumber | Sempre | Número d'identificació nacional suec, de 12 dígits |
| name, givenName, surname | Sempre | Nom complet i les seves parts |
| signature | Sempre | Signatura XML codificada en Base 64 |
| ocspResponse | Sempre | Estat signat del certificat de la signatura |
| device.ipAddress, device.uhi | Es retorna | IP vista per BankID, identificador únic del maquinari |
| bankIdIssueDate | Es retorna | Data d'emissió del BankID |
| stepUp.mrtd, stepUp.face | Si s'ha executat un step-up | Si s'ha fet la comprovació del xip o la facial |
| risk | Només si se sol·licita | low, moderate o high |
| Adreça, nacionalitat, retrat | Mai | No forma part de la resposta |
La resposta de collect per a una ordre completada.[6]
La data de naixement està codificada al personnummer, de manera que cada inici de sessió inclou una comprovació d'edat.[3]
Nivell de garantia i valor jurídic
Suècia va notificar un únic sistema paraigua en virtut d'eIDAS, "Swedish eID", el 14 de desembre de 2020. Hi incloïa BankID, Freja eID i EFOS com a mitjans de nivell substancial i alt.[10] La taula de DIGG de les e-ID sueques notificades situa Mobile BankID, BankID on file i BankID on card al nivell substancial.[11] En el marc de confiança suec se situa al nivell de confiança 3.[3][11]
| Instrument | Què implica per a BankID |
|---|---|
| Marc de confiança de DIGG per a la e-ID sueca | BankID aprovat al nivell de confiança 3, juntament amb les altres e-ID que DIGG inclou en aquest nivell[11] |
| eIDAS, Reglament (UE) núm. 910/2014 | Notificat dins del sistema suec d'identificació electrònica; BankID afirma que una signatura BankID és una signatura electrònica avançada[3][10] |
| PSD2 | Una identificació compleix l'autenticació reforçada de clients; una signatura compleix la vinculació dinàmica[3] |
| Lag (2017:630), cap. 3, secció 7 | Els mitjans d'identificació electrònica eIDAS poden verificar la identitat en les comprovacions contra el blanqueig de capitals[13] |
| Spellagen (2018:1138), cap. 12, secció 2 | Els titulars de llicències de joc han de comprovar la identitat mitjançant una identificació electrònica fiable[14] |
| Codi penal, capítol 15, secció 12 | Utilitzar el BankID d'una altra persona és un ús indegut de documents[3] |
| Lag (2026:1358) | Llei estatal d'identificació electrònica, aplicable a partir de l'1 de desembre de 2026[12] |
Per a la diligència deguda amb el client, la llei sueca contra el blanqueig de capitals diu:
Capítol 3, secció 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"
Font: Sveriges riksdag, SFS 2017:630[13]
En català: els mitjans d'identificació electrònica eIDAS poden verificar la identitat. La diligència deguda en conjunt continua basada en el risc.
A partir del 10 de juliol de 2027 s'aplica el Reglament de la UE contra el blanqueig de capitals (AMLR). El seu article 22(6)(b) accepta mitjans d'identificació electrònica amb "els nivells de garantia 'substancial' o 'alt'", de manera que BankID compleix el requisit.[15] Els projectes finals de normes de l'autoritat de la UE contra el blanqueig de capitals (AMLA) es van enviar a la Comissió el 30 de setembre de 2026 i encara no són llei. Segons aquest projecte, els mitjans d'identificació electrònica "s'haurien d'utilitzar sempre que sigui possible" i les comprovacions remotes de documents són una alternativa per als clients que no els poden utilitzar. El projecte inclou la cartera europea d'identitat digital (EUDI Wallet) entre aquests mitjans.[16]
Nota
SverigeID, una identificació electrònica estatal emesa per l'Autoritat de Policia de Suècia, s'obre l'1 de desembre de 2026. DIGG l'ha aprovada al nivell de confiança suec 4, el més alt. A 5 d'octubre de 2026, encara no és a la llista de la UE de sistemes notificats. És un complement de BankID i Freja eID, no un substitut.[11][17]
Com connectar-se a l'API de BankID Sweden: directament o a través d'un intermediari
La resposta de BankID: "Podeu comprar el servei BankID a un banc o a través d'un revenedor."[4]
Part usuària directa
Compreu-lo a un banc i desenvolupeu-lo vosaltres mateixos
- Contracte amb un banc que vengui BankID
- Sol·liciteu el vostre certificat de part usuària (FP) a través de BankID Keygen
- Desenvolupeu la gestió d'inici, QR, recollida, missatges a l'usuari i cancel·lació
- Preu per identificació i per signatura, acordat amb el banc
Ideal per a serveis d'un sol país amb equip propi
A través d'un intermediari o revenedor
Un contracte, una integració
- Contracte amb el revenedor, que és qui compra el servei BankID
- Crideu l'API del revenedor en lloc de la de BankID
- És la integració del revenedor, no la vostra, la que es comunica amb BankID
- Preu per verificació, fixat pel revenedor
La millor opció per a l'alta de clients en diversos països
Totes dues vies funcionen amb les mateixes normes de BankID.[4]
Cap de les dues vies publica els preus. El cost «sol basar-se en el nombre d'identificacions i signatures que es fan», i al sector privat els preus els fixa la competència.[4] Tampoc es publiquen els terminis d'alta, a 5 d'octubre de 2026.
Algunes normes us obliguen en totes dues vies. Les normes contractuals de BankID prohibeixen el «ID switching»: fer servir un inici de sessió per emetre una contrasenya o una altra credencial, o mantenir un usuari connectat mitjançant una galeta més enllà de dues hores d'inactivitat.[4] Poden aparèixer nous codis d'indicació «sense avís previ», i una integració directa ha de gestionar els desconeguts.[6]
Els organismes públics paguen un preu fix a través del sistema d'autorització de DIGG; les empreses privades només es poden connectar al node eIDAS de DIGG.[4][12] La part comercial es tracta a BankID per a empreses a Suècia.
Casos d'ús de l'API de BankID
| Cas d'ús | Què us aporta BankID | Norma que ho fonamenta |
|---|---|---|
| Alta de clients KYC i AML | Identitat verificada a partir d'una identificació electrònica notificada | Lag (2017:630), capítol 3, secció 7[13] |
| Joc en línia | Identificació electrònica fiable en el registre | Spellagen, capítol 12, secció 2[14] |
| Verificació de l'edat | Data de naixement a partir del personnummer | Resposta de la crida collect[6] |
| Pagaments | Autenticació reforçada de clients i vinculació dinàmica | PSD2[3] |
| Contractes i crèdit | Signatura electrònica avançada | eIDAS, Reglament (UE) núm. 910/2014[3] |
El joc afegeix dues normes: el registre en línia es limita als residents a Suècia, i les llicències no poden cobrir persones menors de 18 anys.[14]
Límits i alternatives
Un BankID requereix un personnummer suec i un banc emissor.[5]
- Menors: el banc fixa el límit d'edat, "en la majoria dels casos ... 13 o 18 anys", i els menors necessiten el consentiment dels pares.[5]
- Els suecs que viuen a l'estranger poden perdre el dret a tenir-ne quan se'ls dona de baixa del registre SPAR.[5]
- Ciutadans estrangers: la llista de notícies de BankID anuncia la renovació amb passaports de la UE per a ciutadans no suecs registrats des del 5 de maig de 2026. Els visitants i els no residents sense personnummer no en poden obtenir cap.[5][9]
Segons Computer Sweden, la policia va informar d'una caiguda del 90% de les estafes telefòniques relacionades amb inicis de sessió de BankID després de l'arribada dels codis QR. El 2026 BankID va afegir un avís de pagament i la verificació facial addicional.[9]
Per a la resta, l'alternativa és una verificació de document: llegir per NFC el xip del passaport o del document d'identitat (vegeu Verificació d'identificació electrònica per NFC i seguretat del xip), comprovar la prova de vida i comparar la cara.
1Ofereix BankID primer als usuaris suecs
App al mateix dispositiu o codi QR en un ordinador.
L'usuari completa una ordre de BankID
Accepta el resultat signat
Personnummer, nom, signatura, OCSP.
Verifica amb un document
Lectura del xip per NFC, prova de vida i comparació facial.
2Afegeix l'adreça d'una altra font
BankID no la retorna.
3Fes el cribratge i decideix
Comprovacions de sancions i PEP. La decisió continua sent teva.
Primer la identificació electrònica, el document com a alternativa, una sola decisió al final.
Llista de comprovació per integrar BankID
- Decideix entre un contracte directe amb un banc i un revenedor.
- Fes una llista dels atributs que necessita la teva política i de la font de l'adreça.
- Admet l'inici al mateix dispositiu i el codi QR a l'ordinador.
- Consulta collect cada dos segons i atura't quan l'estat sigui failed.[6]
- Associa cada codi hint a un missatge per a l'usuari, inclosos els desconeguts.[6]
- Decideix sobre l'indicador de risc i una verificació addicional.
- Desa la signatura i la resposta OCSP per a l'auditoria.[6]
- Tanca les sessions inactives dins de la regla de les dues hores.[4]
- Crea l'alternativa documental per als usuaris sense BankID.
- Feu proves a l'entorn de proves de BankID abans de passar a producció.
Com us ajuda Didit amb la verificació amb BankID Sweden
BankID Sweden ja està disponible a Didit. L'usuari tria BankID al flux allotjat o a l'SDK i inicia la sessió al mateix telèfon o amb un codi QR. Didit no demana mai el codi de seguretat de BankID (PIN).
Activeu-lo a la consola a Workflows, ID Verification, Countries, Wallets accepted, o amb l'API de workflows. Un inici de sessió retorna el nom complet, la data de naixement, el personnummer suec, el nivell de garantia (amb l'etiqueta Substantial) i una comprovació de la signatura (un veredicte, no la signatura en brut). No retorna cap adreça ni cap fotografia. Els usuaris sense BankID passen a la captura del document amb lectura del xip NFC, prova de vida i comparació facial dins del mateix workflow. Una comprovació KYC completa costa $0.33, la verificació NFC $0.15 i el cribratge AML $0.20.
Només es facturen els inicis de sessió amb BankID completats. Els cancel·lats, els que esgoten el temps d'espera i els fallits són gratuïts. Les comprovacions de documents es cobren per comprovació. BankID costa $0.20 (preus). Les eID actives són a la pàgina de carteres d'identitat digital.
Captura de pantalla pendent: hosted-flow-wallet-chooser
L'usuari tria BankID al flux de Didit.
Captura de pantalla pendent: hosted-flow-qr
En un ordinador, un codi QR passa l'inici de sessió al telèfon.
Captura de pantalla pendent: console-wallets-accepted
Activació de BankID Sweden a la consola de Didit.
Didit proporciona
- L'inici de sessió amb BankID Sweden al flux allotjat o a l'SDK
- La via del document per als usuaris sense BankID
- Els atributs signats i l'evidència de cada comprovació
Continua sent responsabilitat vostra
- L'avaluació del risc i les polítiques
- La decisió d'alta del client
- La font de l'adreça del client
Accepteu BankID Sweden en el vostre registre des d'avui
Activeu BankID i la via del document en un sol workflow, i pagueu només pels inicis de sessió amb identificació electrònica completats.
Punts clau
- 8.7 milions de persones van utilitzar BankID el 2025, i el 99.9% dels suecs registrats d'entre 18 i 67 anys en tenen.
- BankID es contracta amb un banc i l'integreu vosaltres mateixos, o bé es passa per un revenedor. Els preus no es publiquen.
- Un inici de sessió retorna el personnummer i el nom, signats, però cap adreça ni cap fotografia.
- La DIGG classifica BankID al nivell substancial, que compleix l'article 22(6)(b) de l'AMLR a partir del 10 de juliol de 2027.
Preguntes freqüents
Quant costa l'API de BankID?
BankID no publica els seus preus. El cost se sol basar en el nombre d'identificacions i signatures, i en el sector privat els preus els fixa la competència.[4] Didit cobra $0.20.
Quines dades retorna BankID?
El personnummer de 12 xifres, el nom complet, el nom i el cognom, la signatura i una resposta OCSP, a més de dades del dispositiu i un nivell de risc opcional. No inclou adreça, nacionalitat ni fotografia.[6]
BankID pot comprovar l'edat d'un usuari?
Sí. El personnummer codifica la data de naixement, de manera que cada inici de sessió us indica l'edat de l'usuari. BankID només està disponible per a menors si el seu banc ho permet, normalment a partir dels 13 o dels 18 anys i amb consentiment parental.[5][6]
Els estrangers poden fer servir BankID?
Només amb un personnummer suec i un compte en un banc emissor. La llista de notícies de BankID anuncia la renovació amb passaports de la UE per a ciutadans no suecs registrats des del 5 de maig de 2026. Els visitants sense personnummer necessiten una altra via, com ara una verificació de document.[5][9]
Quin nivell de garantia té BankID?
Substancial. BankID forma part del sistema suec d'identificació electrònica notificat en virtut d'eIDAS el 14 de desembre de 2020. El sistema està notificat amb nivell substancial i alt, i DIGG classifica els mitjans de BankID amb nivell substancial i amb el nivell de confiança suec 3.[10][11]
BankID és suficient per a la diligència deguda amb el client en matèria de prevenció del blanqueig de capitals a Suècia?
És un mitjà acceptat. La llei contra el blanqueig de capitals, capítol 3, secció 7, permet utilitzar la identificació electrònica d'eIDAS per verificar la identitat. El cribratge, l'avaluació del risc i el seguiment continuen sent obligatoris a banda d'això.[13]
Quant de temps requereix una integració de BankID?
BankID no publica terminis d'incorporació, a data de 5 d'octubre de 2026. Una integració directa requereix un contracte amb un banc, un certificat de part confiant (relying party) de BankID Keygen i la vostra pròpia gestió del QR, de la consulta periòdica (polling) i dels codis d'indicació (hint codes). Un revenedor ho substitueix tot per una sola API.[4][6]
Puc provar BankID abans de passar a producció?
Sí. El lloc per a desenvolupadors de BankID té un portal de proves al costat de la referència de l'API.[6] Passar a producció continua requerint un contracte amb un banc o un revenedor i, en la via directa, un certificat de part confiant sol·licitat a través de BankID Keygen.[4] Proveu també la gestió de codis d'indicació desconeguts, perquè BankID en pot afegir de nous sense avís previ.[6]
SverigeID substitueix BankID?
No. SverigeID, la identificació electrònica estatal que s'obre l'1 de desembre de 2026, és un complement de BankID i Freja. Està aprovada amb el nivell de confiança suec 4, però encara no figura a la llista de la UE de sistemes notificats, a data de 5 d'octubre de 2026.[11][17]
Fonts
- BankID en xifres, BankID, dades de 2025.
- Història, BankID.
- Lleis i normativa, BankID.
- Connecteu la vostra empresa, BankID.
- Obteniu BankID, BankID.
- Referència de l'API /collect, BankID Developers, consultat el 5 d'octubre de 2026.
- El reconeixement facial com a control addicional, notícies de BankID, agost de 2026.
- Document d'identitat digital al col·legi electoral, notícies de BankID, 2026.
- Notícies, BankID, entrades de 2026.
- Visió general dels sistemes d'identificació electrònica prenotificats i notificats en virtut d'eIDAS, Comissió Europea, consultat el 5 d'octubre de 2026.
- Identificacions electròniques i funcions d'atestació aprovades, DIGG.
- Sobre la identificació electrònica, DIGG.
- Lag (2017:630) om åtgärder mot penningtvätt och finansiering av terrorism, Sveriges riksdag.
- Spellagen (2018:1138), text de la llei a lagen.nu.
- Reglament (UE) 2024/1624 (AMLR), article 22, EUR-Lex.
- Informe final, projecte de RTS en virtut de l'article 28(1) de l'AMLR, AMLA, 30 de setembre de 2026.
- Statlig e-legitimation, SverigeID, Autoritat de Policia de Suècia.
Compara totes les eID nacionals a la pàgina de verificació amb eID, o comença per què és la verificació amb eID.
Un sol flux de treball per a Suècia i més enllà
Comença amb BankID, afegeix les eID que els teus usuaris ja tenen i mantén els documents com a alternativa.
Articles relacionats
- e-Devlet per a empreses: verificació d'identitat a Turquia
- Integració de Singpass Myinfo: guia per a empreses a Singapur
- Integració de Cl@ve a Espanya: qui s'hi pot connectar i què fer servir en lloc seu
- Verificació PhilSys: com comproven les empreses el National ID
- Guia OpenID4VP: verificar i acceptar la cartera europea d'identitat digital (EUDI Wallet)
- Reglament eIDAS explicat: què canvia eIDAS 2 (2024/1183)