API do BankID na Suécia: parte utilizadora direta ou intermediário, guia completo
Como uma empresa se liga à API do BankID na Suécia: diretamente através de um banco ou via intermediário, o que devolve um início de sessão, o seu valor jurídico para PBC/FT e jogo, limites e a alternativa documental.
Em resumo
A API do BankID permite a uma empresa identificar um utilizador sueco, ou recolher uma assinatura, através da app BankID. 8.7 milhões de pessoas utilizaram o BankID em 2025.[1] Pode aceder à API de uma de duas formas: contratar o serviço a um banco e integrá-lo como parte utilizadora direta, ou recorrer a um revendedor que já fez a integração.[4]
- Uma autenticação devolve o personnummer de 12 dígitos e o nome, assinados. Sem morada, sem fotografia.[6]
- O BankID integra o sistema sueco de eID (notificado nos níveis substancial e elevado), e a DIGG classifica o BankID no nível substancial. Os preços não são publicados.[4][10][11]
O BankID é a identificação eletrónica (eID) da Suécia: uma app privada emitida pelos bancos segundo regras comuns[3] e aprovada pela agência digital do Estado, a DIGG.[11] Para uma empresa, é a forma habitual de saber quem é um cliente sueco, com uma resposta assinada em vez de uma fotografia de um cartão.
BankID Sweden em resumo
BankID Sweden
A identificação eletrónica emitida pelos bancos da Suécia
Quantas pessoas utilizam o BankID
Fonte: O BankID em números, dados de 2025.[1]
A utilização passou de 4.1 mil milhões de transações em 2019 para 7.9 mil milhões em 2025.[1]
| Setor | Quota de utilização do BankID, 2025 |
|---|---|
| Banca e finanças | 50% |
| Outros serviços privados | 27% |
| Pagamentos móveis | 17% |
| Setor público | 6% |
O BankID em números.[1]
- setembro de 2002FundaçãoÉ constituída a Finansiell ID-Teknik BID.
- junho de 2011Aplicação móvelÉ lançado o Mobile BankID.
- 14 de dezembro de 2020NotificaçãoO sistema sueco de identificação eletrónica, com o BankID, é notificado ao abrigo do eIDAS.
- 17 de agosto de 2026Verificação facialPassa a estar disponível a verificação reforçada por reconhecimento facial.
- 1 de dezembro de 2026SverigeIDA e-ID do Estado entra em funcionamento a par do BankID.
Da fundação da empresa à e-ID do Estado.[2][10][7][17]
O que o utilizador vê
Num telemóvel, a aplicação BankID abre no mesmo dispositivo. Num computador, o utilizador lê um código QR com a aplicação.[6] Segundo a investigação sobre o fluxo do BankID, o utilizador confirma depois com um código de segurança ou biometria. A documentação de referência do método collect do BankID confirma o código através dos seus códigos de erro.[6]
Escolha como verificar
Inicie sessão com a identificação eletrónica que já utiliza.
BankID
Utilizar, em vez disso, um documento de identificação
1O utilizador escolhe o BankID no seu processo de registo.
Num computador: ler com o BankID
Abra a aplicação BankID no telemóvel e leia este código.
2Apenas no computador: um código QR passa o pedido para o telemóvel. Num telemóvel, este ecrã não aparece.[6]
Identifique-se
Verifique quem está a pedir e introduza o seu código de segurança.
3O utilizador confirma na aplicação (código de segurança ou biometria, segundo a investigação sobre o fluxo do BankID).[6]
Verificação adicional
Aproxime o passaporte ou o cartão de identificação, ou tire uma selfie.
4Verificação reforçada opcional que o serviço pode pedir.[7]
Está verificado
- NomePartilhado
- PersonnummerPartilhado
- MoradaNão partilhada
- RetratoNão partilhado
5De volta ao seu serviço com o resultado assinado.[6]
O ecrã 4 é opcional: uma leitura NFC de um passaporte ou cartão de identificação, ou, desde 17 de agosto de 2026, reconhecimento facial comparado com a fotografia do chip de um passaporte ou cartão de identificação sueco.[6][7] As cartas de condução não têm chip, pelo que não podem ser usadas para esta verificação reforçada.[7]
Vídeo pendente: flow-qr-cross-device
Um início de sessão entre dispositivos com código QR, do início ao fim.
O que a API do BankID devolve a uma empresa
O seu backend inicia um pedido com /auth (identificar) ou /sign e, depois, chama /collect a cada dois segundos enquanto o pedido está pendente.[6] Quando o utilizador confirma, a resposta inclui completionData.
O utilizador confirma na aplicação BankID
Uma integração direta com o BankID, simplificada. Os códigos de indicação dizem-lhe o que mostrar ao utilizador.[6]
| Campo | Quando | O que é |
|---|---|---|
| personalNumber | Sempre | Número de identificação nacional sueco, 12 dígitos |
| name, givenName, surname | Sempre | Nome completo e as suas partes |
| signature | Sempre | Assinatura XML codificada em Base 64 |
| ocspResponse | Sempre | Estado do certificado assinado relativo à assinatura |
| device.ipAddress, device.uhi | Devolvido | IP registado pelo BankID, identificador único de hardware |
| bankIdIssueDate | Devolvido | Data de emissão do BankID |
| stepUp.mrtd, stepUp.face | Se tiver sido executada uma verificação reforçada | Indica se foi feita a verificação do chip ou a verificação facial |
| risk | Apenas se solicitado | baixo, moderado ou elevado |
| Morada, nacionalidade, retrato | Nunca | Não faz parte da resposta |
A resposta de collect para uma ordem concluída.[6]
A data de nascimento está codificada no personnummer, pelo que cada início de sessão inclui uma verificação de idade.[3]
Nível de garantia e valor jurídico
A Suécia notificou um esquema agregador ao abrigo do eIDAS, "Swedish eID", em 14 de dezembro de 2020, indicando o BankID, o Freja eID e o EFOS como meios de identificação eletrónica nos níveis substancial e elevado.[10] A própria tabela da DIGG com os e-IDs suecos notificados coloca o Mobile BankID, o BankID on file e o BankID on card no nível substancial.[11] No quadro de confiança sueco, situa-se no nível de confiança 3.[3][11]
| Instrumento | O que significa para o BankID |
|---|---|
| Quadro de confiança da DIGG para o e-ID sueco | BankID aprovado no nível de confiança 3, a par dos outros e-IDs que a DIGG indica nesse nível[11] |
| eIDAS, Regulamento (UE) n.º 910/2014 | Notificado no âmbito do sistema sueco de identificação eletrónica; o BankID afirma que uma assinatura BankID é uma assinatura eletrónica avançada[3][10] |
| PSD2 | Uma identificação cumpre a autenticação forte do cliente; uma assinatura cumpre a ligação dinâmica[3] |
| Lag (2017:630), cap. 3, sec. 7 | Os meios de identificação eletrónica eIDAS podem verificar a identidade para efeitos de controlos de prevenção do branqueamento de capitais[13] |
| Spellagen (2018:1138), cap. 12, secção 2 | Os titulares de licenças de jogo devem verificar a identidade através de identificação eletrónica fiável[14] |
| Código Penal, capítulo 15, secção 12 | Utilizar o BankID de outra pessoa constitui uso indevido de documentos[3] |
| Lag (2026:1358) | Lei da identificação eletrónica estatal, aplicável a partir de 1 de dezembro de 2026[12] |
Quanto à diligência devida relativa à clientela, a lei sueca de prevenção do branqueamento de capitais estabelece:
Capítulo 3, secção 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"
Fonte: Sveriges riksdag, SFS 2017:630[13]
Em português: os meios de identificação eletrónica eIDAS podem verificar a identidade. A diligência devida, no seu conjunto, continua a basear-se no risco.
A partir de 10 de julho de 2027 aplica-se o Regulamento da UE relativo ao Branqueamento de Capitais (AMLR). O seu artigo 22(6)(b) aceita meios de identificação eletrónica com "os níveis de garantia 'substancial' ou 'elevado'", pelo que o BankID cumpre o requisito.[15] Os projetos finais de normas da autoridade da UE de combate ao branqueamento de capitais (AMLA) foram enviados à Comissão em 30 de setembro de 2026 e ainda não são lei. Segundo esse projeto, os meios de identificação eletrónica "devem ser utilizados sempre que possível" e as verificações remotas de documentos são uma alternativa de recurso para os clientes que não os possam utilizar. O projeto inclui a carteira europeia de identidade digital (EUDI Wallet) entre esses meios.[16]
Nota
O SverigeID, uma identificação eletrónica estatal emitida pela Autoridade Policial sueca, entra em funcionamento em 1 de dezembro de 2026. A DIGG aprovou-o no nível de confiança sueco 4, o mais elevado. À data de 5 de outubro de 2026, ainda não consta da lista da UE de sistemas notificados. É um complemento do BankID e do Freja eID, não um substituto.[11][17]
Como ligar à API BankID Sweden: diretamente ou através de um intermediário
A resposta do BankID: "Pode adquirir o serviço BankID junto de um banco ou através de um revendedor."[4]
Parte utilizadora direta
Comprar a um banco e desenvolver internamente
- Celebrar contrato com um banco que comercializa o BankID
- Encomendar o seu certificado de parte utilizadora (FP) através do BankID Keygen
- Desenvolver o início, o QR, a recolha, as mensagens ao utilizador e o tratamento do cancelamento
- Preço por identificação e por assinatura, acordado com o banco
Mais indicado para serviços num só país com equipa interna
Através de um intermediário ou revendedor
Um contrato, uma integração
- Contrato com o revendedor, que adquire o serviço BankID
- Chama a API do revendedor em vez da API do BankID
- É a integração do revendedor, e não a sua, que comunica com o BankID
- Preço por verificação, fixado pelo revendedor
Mais indicado para onboarding em vários países
Ambas as vias funcionam ao abrigo das mesmas regras do BankID.[4]
Os preços não são publicados em nenhuma das vias. O custo "baseia-se normalmente no número de identificações e assinaturas efetuadas" e, no setor privado, os preços são definidos pela concorrência.[4] Os prazos de adesão também não são publicados, à data de 5 de outubro de 2026.
Algumas regras vinculam-no em ambas as vias. As regras contratuais do BankID proíbem o "ID switching": utilizar um início de sessão para emitir uma palavra-passe ou outra credencial, ou manter um utilizador com sessão iniciada através de cookie para além de duas horas de inatividade.[4] Podem surgir novos códigos de indicação (hint codes) "sem aviso prévio", e uma integração direta tem de tratar os códigos desconhecidos.[6]
Os organismos públicos pagam um preço fixo através do sistema de autorização da DIGG. As empresas privadas só podem aderir ao nó eIDAS da DIGG.[4][12] A vertente comercial é tratada em BankID para empresas na Suécia.
Casos de utilização da API do BankID
| Caso de utilização | O que o BankID lhe dá | Regra aplicável |
|---|---|---|
| Onboarding KYC e AML | Identidade verificada a partir de um meio de identificação eletrónica notificado | Lag (2017:630) cap. 3, secção 7[13] |
| Jogo online | Identificação eletrónica fiável no registo | Spellagen cap. 12, secção 2[14] |
| Verificação de idade | Data de nascimento a partir do personnummer | Resposta do pedido collect[6] |
| Pagamentos | Autenticação forte do cliente e ligação dinâmica | PSD2[3] |
| Contratos e crédito | Assinatura eletrónica avançada | eIDAS, Regulamento (UE) n.º 910/2014[3] |
O jogo acrescenta duas regras: o registo online está limitado a residentes na Suécia e as licenças não podem abranger menores de 18 anos.[14]
Limites e alternativas
Um BankID exige um personnummer sueco e um banco emissor.[5]
- Menores: o banco define o limite de idade, "na maioria dos casos ... 13 ou 18 anos", e os menores precisam do consentimento dos pais.[5]
- Os suecos no estrangeiro podem perder a elegibilidade quando são removidos do registo SPAR.[5]
- Cidadãos estrangeiros: a lista de notícias do BankID anuncia a renovação com passaportes da UE para cidadãos não suecos registados desde 5 de maio de 2026; visitantes e não residentes sem personnummer não podem obter um.[5][9]
Segundo a Computer Sweden, a polícia registou uma queda de 90% nas burlas telefónicas associadas a autenticações BankID após a introdução dos códigos QR. Em 2026, o BankID acrescentou um aviso de pagamento e a verificação reforçada por reconhecimento facial.[9]
Para todos os outros, a alternativa é uma verificação de documento: ler o chip do passaporte ou do cartão de identificação por NFC (ver verificação eID por NFC e segurança do chip), verificar a prova de vida e comparar o rosto.
1Ofereça primeiro o BankID aos utilizadores suecos
App no mesmo dispositivo ou código QR num computador.
O utilizador conclui um pedido BankID
Aceite o resultado assinado
Personnummer, nome, assinatura, OCSP.
Verifique com um documento
Leitura do chip por NFC, prova de vida e correspondência facial.
2Obtenha a morada a partir de outra fonte
O BankID não a devolve.
3Faça a triagem e decida
Verificações de sanções e de PEP; a decisão continua a ser sua.
Primeiro a eID, o documento como alternativa, uma única decisão no final.
Lista de verificação da integração BankID
- Decida entre um contrato direto com um banco e um revendedor.
- Liste os atributos de que a sua política necessita e a fonte da morada.
- Suporte o arranque no mesmo dispositivo e o código QR no computador.
- Consulte o collect a cada dois segundos e pare quando o resultado for failed.[6]
- Associe cada hint code a uma mensagem para o utilizador, incluindo os desconhecidos.[6]
- Decida sobre o indicador de risco e uma verificação reforçada.
- Guarde a assinatura e a resposta OCSP para efeitos de auditoria.[6]
- Termine as sessões inativas dentro da regra das duas horas.[4]
- Crie a alternativa por documento para utilizadores sem BankID.
- Teste no ambiente de testes do BankID antes de entrar em produção.
Como a Didit ajuda na verificação com BankID Sweden
O BankID Sweden está disponível na Didit. O utilizador escolhe o BankID no fluxo alojado ou no SDK e autentica-se no mesmo telemóvel ou por código QR. A Didit nunca pede o código de segurança do BankID (PIN).
Ative-o na consola em Workflows, ID Verification, Countries, Wallets accepted, ou através da API de workflows. Uma autenticação devolve o nome completo, a data de nascimento, o personnummer sueco, o nível de garantia (indicado como Substantial) e uma verificação da assinatura (um resultado, não a assinatura em bruto). Não devolve morada nem fotografia. Os utilizadores sem BankID passam para a captura de documento com leitura do chip NFC, prova de vida e correspondência facial no mesmo workflow. Uma verificação KYC completa custa $0.33, a verificação NFC $0.15 e a triagem AML $0.20.
Só são faturadas as autenticações BankID concluídas. As canceladas, expiradas e falhadas são gratuitas. As verificações de documentos são cobradas por verificação. O BankID custa $0.20 (preços). As eID ativas estão na página carteiras de identidade digital.
Captura de ecrã pendente: hosted-flow-wallet-chooser
O utilizador escolhe o BankID no fluxo da Didit.
Captura de ecrã pendente: hosted-flow-qr
Num computador, um código QR passa a autenticação para o telemóvel.
Captura de ecrã pendente: console-wallets-accepted
Ativar o BankID Sweden na consola da Didit.
A Didit fornece
- Autenticação com BankID Sweden no fluxo alojado ou no SDK
- A via documental para utilizadores sem BankID
- Os atributos assinados e a prova de cada verificação
Fica do seu lado
- A avaliação de risco e as políticas
- A decisão de admissão do cliente
- A fonte da morada do cliente
Aceite hoje o BankID Sweden no seu registo
Ative o BankID e a via documental num único workflow e pague apenas pelas autenticações eID concluídas.
Pontos-chave
- 8.7 milhões de pessoas usaram o BankID em 2025, e 99.9% dos suecos registados entre os 18 e os 67 anos têm um.
- Pode comprar o BankID a um banco e integrá-lo por conta própria, ou recorrer a um revendedor. Os preços não são publicados.
- Uma autenticação devolve o personnummer e o nome, assinados, mas não devolve morada nem fotografia.
- A DIGG classifica o BankID no nível substancial, o que cumpre o artigo 22(6)(b) do AMLR a partir de 10 de julho de 2027.
Perguntas frequentes
Quanto custa a API do BankID?
O BankID não publica preços. O custo baseia-se normalmente no número de identificações e assinaturas, e os preços no setor privado são definidos pela concorrência.[4] A Didit cobra $0.20.
Que dados devolve o BankID?
O personnummer de 12 dígitos, o nome completo, o nome próprio e o apelido, a assinatura e uma resposta OCSP, além de dados do dispositivo e de um nível de risco opcional. Não devolve morada, nacionalidade nem fotografia.[6]
O BankID permite verificar a idade de um utilizador?
Sim. O personnummer codifica a data de nascimento, pelo que cada início de sessão indica a idade do utilizador. O próprio BankID só está disponível para menores quando o respetivo banco o permite, normalmente a partir dos 13 ou dos 18 anos e com consentimento parental.[5][6]
Os estrangeiros podem usar o BankID?
Apenas com um personnummer sueco e uma conta num banco emissor. A lista de notícias do BankID anuncia a renovação com passaportes da UE para cidadãos não suecos registados desde 5 de maio de 2026. Os visitantes sem personnummer precisam de outra via, como uma verificação de documento.[5][9]
Qual é o nível de garantia do BankID?
Substancial. O BankID faz parte do sistema sueco de eID notificado ao abrigo do eIDAS em 14 de dezembro de 2020. O sistema está notificado nos níveis Substancial e Elevado, e a DIGG indica os meios do BankID no nível Substancial e no nível de confiança sueco 3.[10][11]
O BankID é suficiente para a diligência devida relativa à clientela em matéria de AML na Suécia?
É um meio aceite. A lei de combate ao branqueamento de capitais, capítulo 3, secção 7, permite usar a identificação eletrónica eIDAS para verificar a identidade. A triagem, a avaliação de risco e o acompanhamento continuam a ser exigidos além disso.[13]
Quanto tempo demora uma integração com o BankID?
O BankID não publica prazos de adesão, à data de 5 de outubro de 2026. Uma integração direta exige um contrato com um banco, um certificado de parte utilizadora emitido pelo BankID Keygen e o seu próprio tratamento do código QR, da consulta periódica (polling) e dos códigos de sugestão (hint codes). Um revendedor substitui tudo isto por uma única API.[4][6]
Posso testar o BankID antes de entrar em produção?
Sim. O site para programadores do BankID tem um portal de testes junto à referência da API.[6] A entrada em produção continua a exigir um contrato com um banco ou com um revendedor e, na via direta, um certificado de parte utilizadora pedido através do BankID Keygen.[4] Teste também o tratamento de códigos de sugestão desconhecidos, porque o BankID pode acrescentar novos códigos sem aviso prévio.[6]
O SverigeID substitui o BankID?
Não. O SverigeID, a e-ID estatal que abre em 1 de dezembro de 2026, é um complemento do BankID e do Freja. Está aprovado no nível de confiança sueco 4, mas ainda não consta da lista da UE de sistemas notificados, à data de 5 de outubro de 2026.[11][17]
Fontes
- O BankID em números, BankID, dados de 2025.
- História, BankID.
- Leis e regulamentos, BankID.
- Ligue a sua empresa, BankID.
- Obter o BankID, BankID.
- Referência da API /collect, BankID Developers, consultado em 5 de outubro de 2026.
- Reconhecimento facial como controlo adicional, notícias do BankID, agosto de 2026.
- Cartão de identificação digital no local de voto, notícias do BankID, 2026.
- Notícias, BankID, entradas de 2026.
- Panorâmica dos sistemas de eID pré-notificados e notificados ao abrigo do eIDAS, Comissão Europeia, consultado em 5 de outubro de 2026.
- E-IDs e funções de atestação aprovadas, DIGG.
- Sobre a identificação eletrónica, DIGG.
- Lag (2017:630) om åtgärder mot penningtvätt och finansiering av terrorism, Sveriges riksdag.
- Spellagen (2018:1138), texto legal no lagen.nu.
- Regulamento (UE) 2024/1624 (AMLR), artigo 22, EUR-Lex.
- Relatório Final, projeto de RTS ao abrigo do artigo 28(1) do AMLR, AMLA, 30 de setembro de 2026.
- Statlig e-legitimation, SverigeID, Autoridade Policial Sueca.
Compare todos os eID nacionais na página de verificação de eID, ou comece por o que é a verificação de eID.
Um único fluxo para a Suécia e não só
Comece pelo BankID, acrescente os eID que os seus utilizadores já têm e mantenha os documentos como alternativa.
Artigos relacionados
- e-Devlet para empresas: como funciona a verificação de identidade na Turquia
- Integração do Singpass Myinfo: guia para empresas em Singapura
- Integração do Cl@ve em Espanha: quem se pode ligar e que alternativas usar
- Verificação PhilSys: como as empresas verificam o National ID
- Verificador OpenID4VP: aceitação da carteira de identidade digital europeia (EUDI Wallet)
- Regulamento eIDAS explicado: o que muda com o eIDAS 2 (2024/1183)