API do BankID na Suécia: relying party direta ou broker, guia completo
Como uma empresa se conecta à API do BankID na Suécia: diretamente via um banco ou por meio de um broker, o que um login retorna, sua validade jurídica para PLD e apostas, limites e a alternativa por documento.
Em resumo
A API do BankID permite que uma empresa identifique um usuário sueco, ou colete uma assinatura, pelo aplicativo BankID. 8.7 milhões de pessoas usaram o BankID em 2025.[1] Há duas formas de acessar a API: contratar o serviço com um banco e integrá-lo como parte confiante direta, ou usar um revendedor que já fez a integração.[4]
- Um login retorna o personnummer de 12 dígitos e o nome, assinados. Sem endereço, sem foto.[6]
- O BankID faz parte do esquema sueco de eID (notificado nos níveis substancial e elevado), e a DIGG classifica o BankID como substancial. Os preços não são publicados.[4][10][11]
O BankID é a identificação eletrônica (eID) da Suécia: um aplicativo privado emitido pelos bancos sob regras comuns[3] e aprovado pela agência digital do Estado, a DIGG.[11] Para uma empresa, é a forma padrão de saber quem é um cliente sueco, com uma resposta assinada em vez de uma foto de um documento.
BankID Sweden em resumo
BankID Sweden
A identificação eletrônica da Suécia emitida pelos bancos
Quantas pessoas usam o BankID
Fonte: BankID in numbers, dados de 2025.[1]
O uso cresceu de 4.1 bilhões de transações em 2019 para 7.9 bilhões em 2025.[1]
| Setor | Participação no uso do BankID, 2025 |
|---|---|
| Bancos e finanças | 50% |
| Outros serviços privados | 27% |
| Pagamentos móveis | 17% |
| Setor público | 6% |
BankID em números.[1]
- Setembro de 2002FundaçãoÉ criada a Finansiell ID-Teknik BID.
- Junho de 2011Aplicativo móvelÉ lançado o Mobile BankID.
- 14 de dezembro de 2020NotificaçãoO sistema sueco de eID, com o BankID, é notificado nos termos do eIDAS.
- 17 de agosto de 2026Verificação facialA verificação adicional por reconhecimento facial passa a ficar disponível.
- 1 de dezembro de 2026SverigeIDA identidade eletrônica estatal entra em operação ao lado do BankID.
Da fundação da empresa à identidade eletrônica estatal.[2][10][7][17]
O que o usuário vê
No celular, o aplicativo BankID abre no mesmo dispositivo. No computador, o usuário escaneia um QR code com o aplicativo.[6] Segundo pesquisas sobre o fluxo do BankID, o usuário então confirma com um código de segurança ou biometria. A referência da chamada collect do BankID confirma o código por meio dos seus códigos de erro.[6]
Escolha como verificar
Entre com a identidade eletrônica que você já usa.
BankID
Usar um documento de identidade
1O usuário escolhe o BankID no seu cadastro.
No computador: escaneie com o BankID
Abra o aplicativo BankID no seu celular e escaneie este código.
2Só no computador: um QR code transfere o pedido para o celular. No celular, esta tela é pulada.[6]
Identifique-se
Confira quem está solicitando e, em seguida, digite seu código de segurança.
3O usuário confirma no aplicativo (código de segurança ou biometria, segundo pesquisas sobre o fluxo do BankID).[6]
Verificação adicional
Aproxime seu passaporte ou documento de identidade, ou tire uma selfie.
4Verificação adicional opcional que o serviço pode solicitar.[7]
Você está verificado
- NomeCompartilhado
- PersonnummerCompartilhado
- EndereçoNão compartilhado
- FotoNão compartilhado
5De volta ao seu serviço com o resultado assinado.[6]
A tela 4 é opcional: uma leitura NFC de um passaporte ou carteira de identidade, ou, desde 17 de agosto de 2026, reconhecimento facial comparado à foto do chip de um passaporte ou carteira de identidade sueca.[6][7] Carteiras de habilitação não têm chip, então não podem ser usadas nesta verificação adicional.[7]
Vídeo pendente: flow-qr-cross-device
Um login entre dispositivos com QR code, do início ao fim.
O que a API do BankID retorna para uma empresa
Seu backend inicia um pedido com /auth (identificação) ou /sign e chama /collect a cada dois segundos enquanto ele estiver pendente.[6] Quando o usuário confirma, a resposta traz completionData.
O usuário confirma no app BankID
Uma integração direta com o BankID, simplificada. Os códigos de dica indicam o que mostrar ao usuário.[6]
| Campo | Quando | O que é |
|---|---|---|
| personalNumber | Sempre | Número de identificação nacional sueco, 12 dígitos |
| name, givenName, surname | Sempre | Nome completo e suas partes |
| signature | Sempre | Assinatura XML codificada em Base 64 |
| ocspResponse | Sempre | Status assinado do certificado usado na assinatura |
| device.ipAddress, device.uhi | Retornado | IP visto pelo BankID, identificador único de hardware |
| bankIdIssueDate | Retornado | Data de emissão do BankID |
| stepUp.mrtd, stepUp.face | Se um step-up foi executado | Se a verificação do chip ou a verificação facial foi feita |
| risk | Somente se solicitado | baixo, moderado ou alto |
| Endereço, nacionalidade, foto | Nunca | Não faz parte da resposta |
A resposta do collect para um pedido concluído.[6]
A data de nascimento está codificada no personnummer, então toda autenticação já traz uma verificação de idade.[3]
Nível de garantia e validade jurídica
A Suécia notificou um único regime guarda-chuva ao abrigo do eIDAS, "Swedish eID", em 14 de dezembro de 2020, com BankID, Freja eID e EFOS como seus meios nos níveis Substancial e Elevado.[10] A própria tabela da DIGG de e-IDs suecas notificadas coloca Mobile BankID, BankID on file e BankID on card no nível Substancial.[11] Na estrutura de confiança sueca, o BankID fica no nível de confiança 3.[3][11]
| Instrumento | O que significa para o BankID |
|---|---|
| Estrutura de confiança da DIGG para e-ID sueca | BankID aprovado no nível de confiança 3, junto com as demais e-IDs que a DIGG lista nesse nível[11] |
| eIDAS, Regulamento (UE) n.º 910/2014 | Notificado no âmbito do sistema sueco de identificação eletrônica; o BankID declara que uma assinatura BankID é uma assinatura eletrônica avançada[3][10] |
| PSD2 | Uma identificação atende à autenticação forte do cliente; uma assinatura atende à vinculação dinâmica[3] |
| Lag (2017:630), cap. 3, seção 7 | Meios de identificação eletrônica eIDAS podem verificar a identidade nas verificações de prevenção à lavagem de dinheiro[13] |
| Spellagen (2018:1138), cap. 12, seção 2 | Os licenciados de jogos de azar devem verificar a identidade por meio de identificação eletrônica confiável[14] |
| Código Penal, capítulo 15, seção 12 | Usar o BankID de outra pessoa configura uso indevido de documentos[3] |
| Lag (2026:1358) | Lei da identidade eletrônica estatal, aplicável a partir de 1 de dezembro de 2026[12] |
Para a devida diligência do cliente, a lei sueca de prevenção à lavagem de dinheiro diz:
Capítulo 3, seçã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: meios de identificação eletrônica eIDAS podem verificar a identidade. A devida diligência como um todo continua baseada em risco.
A partir de 10 de julho de 2027, aplica-se o Regulamento Antilavagem de Dinheiro da UE (AMLR). O seu artigo 22(6)(b) aceita meios de identificação eletrônica com "os níveis de garantia 'substancial' ou 'elevado'", portanto o BankID atende ao requisito.[15] Os projetos finais de normas da autoridade antilavagem de dinheiro da UE (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 usados sempre que possível" e as verificações remotas de documentos são uma alternativa para clientes que não podem usá-los. O projeto inclui a carteira europeia de identidade digital (EUDI Wallet) entre esses meios.[16]
Observação
O SverigeID, uma identidade eletrônica estatal emitida pela Autoridade Policial Sueca, entra em funcionamento em 1 de dezembro de 2026. A DIGG o aprovou no nível de confiança sueco 4, o mais alto. Em 5 de outubro de 2026, ainda não consta da lista da UE de sistemas notificados. É um complemento ao BankID e ao Freja eID, não um substituto.[11][17]
Como se conectar à API do BankID Sweden: diretamente ou por meio de um intermediário
A resposta do BankID: "Você pode adquirir o serviço BankID de um banco ou por meio de um revendedor."[4]
Parte utilizadora direta
Contratar com um banco e desenvolver por conta própria
- Firmar contrato com um banco que vende BankID
- Solicitar seu certificado de parte utilizadora (FP) pelo BankID Keygen
- Implementar start, QR, collect, mensagens ao usuário e o tratamento de cancelamento
- Preço por identificação e por assinatura, acordado com o banco
Ideal para serviços em um único país com equipe interna
Por meio de um intermediário ou revendedor
Um contrato, uma integração
- Contrato com o revendedor, que compra o serviço BankID
- Você chama a API do revendedor em vez da API do BankID
- A integração do revendedor, não a sua, se comunica com o BankID
- Preço por verificação, definido pelo revendedor
Melhor para onboarding em vários países
As duas vias funcionam sob as mesmas regras do BankID.[4]
Os preços não são publicados em nenhuma das vias. O custo "normalmente se baseia na quantidade de identificações e assinaturas realizadas", e os preços no setor privado são definidos pela concorrência.[4] Os prazos de onboarding também não são publicados, em 5 de outubro de 2026.
Algumas regras se aplicam a você nas duas vias. As regras contratuais do BankID proíbem o "ID switching": usar um login para emitir uma senha ou outra credencial, ou manter um usuário conectado por cookie após duas horas de inatividade.[4] Novos hint codes podem surgir "sem aviso prévio", e uma integração direta precisa tratar os desconhecidos.[6]
Os órgãos públicos pagam um preço fixo pelo sistema de autorização da DIGG. As empresas privadas só podem aderir ao nó eIDAS da DIGG.[4][12] O lado comercial está em BankID para empresas na Suécia.
Casos de uso da API do BankID
| Caso de uso | O que o BankID oferece | Regra aplicável |
|---|---|---|
| Onboarding de KYC e PLD | Identidade verificada a partir de uma eID notificada | Lag (2017:630) cap. 3, seção 7[13] |
| Apostas online | Identificação eletrônica confiável no cadastro | Spellagen cap. 12, seção 2[14] |
| Verificação de idade | Data de nascimento a partir do personnummer | Resposta do collect[6] |
| Pagamentos | Autenticação forte do cliente e vinculação dinâmica | PSD2[3] |
| Contratos e crédito | Assinatura eletrônica avançada | eIDAS, Regulamento (UE) nº 910/2014[3] |
As apostas acrescentam duas regras: o cadastro online é limitado a residentes na Suécia, e as licenças não podem abranger menores de 18 anos.[14]
Limites e alternativas
O BankID exige um personnummer sueco e um banco emissor.[5]
- Menores: o banco define o limite de idade, "mais comumente ... 13 ou 18 anos", e menores precisam do consentimento dos pais.[5]
- Suecos no exterior podem perder a elegibilidade quando são removidos do registro 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 registrados 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 relatou uma queda de 90% nos golpes por telefone envolvendo logins com BankID após a chegada dos códigos QR. Em 2026, o BankID adicionou um alerta de pagamento e a etapa adicional de verificação facial.[9]
Para todos os demais, a alternativa é uma verificação de documento: ler o chip do passaporte ou da carteira de identidade por NFC (veja verificação de eID por NFC e segurança do chip), verificar a prova de vida e comparar o rosto.
1Ofereça o BankID primeiro aos usuários suecos
App no mesmo dispositivo ou QR no computador.
O usuário 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.
2Adicione o endereço a partir de outra fonte
O BankID não o retorna.
3Faça a triagem e decida
Verificações de sanções e PEP. A decisão continua sendo sua.
eID primeiro, documento como alternativa, uma única decisão no final.
Checklist de integração do BankID
- Escolha entre um contrato direto com um banco e um revendedor.
- Liste os atributos que sua política exige e a fonte do endereço.
- Ofereça suporte à abertura no mesmo dispositivo e ao código QR no desktop.
- Consulte o collect a cada dois segundos e pare em failed.[6]
- Associe cada hint code a uma mensagem para o usuário, incluindo os desconhecidos.[6]
- Decida sobre o indicador de risco e uma etapa adicional de verificação.
- Armazene a assinatura e a resposta OCSP para auditoria.[6]
- Encerre sessões ociosas dentro da regra das duas horas.[4]
- Crie a alternativa por documento para usuários sem BankID.
- Faça testes no ambiente de testes do BankID antes de entrar em produção.
Como a Didit ajuda com a verificação por BankID Sweden
O BankID Sweden já está disponível na Didit. O usuário escolhe o BankID no fluxo hospedado ou no SDK e faz login no mesmo celular ou por QR code. A Didit nunca pede o código de segurança (PIN) do BankID.
Ative no console em Workflows, ID Verification, Countries, Wallets accepted, ou pela API de workflows. Um login retorna o nome completo, a data de nascimento, o personnummer sueco, o nível de garantia (com o rótulo Substantial) e uma verificação de assinatura (um resultado, não a assinatura bruta). Sem endereço, sem foto. Usuários 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.
Somente os logins concluídos com BankID são cobrados; os cancelados, expirados e com falha são gratuitos. As verificações de documentos são cobradas por verificação. O BankID custa $0.20 (preços); as eIDs ativas estão na página carteiras de identidade digital.
Captura de tela pendente: hosted-flow-wallet-chooser
O usuário escolhe o BankID no fluxo da Didit.
Captura de tela pendente: hosted-flow-qr
No computador, um QR code transfere o login para o celular.
Captura de tela pendente: console-wallets-accepted
Ativação do BankID Sweden no console da Didit.
A Didit fornece
- Login por BankID Sweden no fluxo hospedado ou no SDK
- A rota por documento para usuários sem BankID
- Os atributos assinados e a evidência de cada verificação
Fica com você
- A avaliação de risco e as políticas
- A decisão de onboarding
- A fonte do endereço do cliente
Aceite o BankID Sweden no seu cadastro hoje
Ative o BankID e a rota por documento em um único workflow e pague apenas pelos logins por eID concluídos.
Principais pontos
- 8.7 milhões de pessoas usaram o BankID em 2025, e 99.9% dos suecos registrados entre 18 e 67 anos têm um.
- Você contrata o BankID com um banco e faz a integração por conta própria, ou usa um revendedor; os preços não são publicados.
- Um login retorna o personnummer e o nome, assinados, mas sem endereço e sem foto.
- A DIGG classifica o BankID no nível Substantial, o que atende ao 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 geralmente se baseia 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.
Quais dados o BankID retorna?
O personnummer de 12 dígitos, o nome completo, o prenome e o sobrenome, a assinatura e uma resposta OCSP, além de dados do dispositivo e um nível de risco opcional. Não retorna endereço, nacionalidade nem foto.[6]
O BankID pode verificar a idade de um usuário?
Sim. O personnummer codifica a data de nascimento, então cada login informa a idade do usuário. O próprio BankID só está disponível para menores quando o banco deles permite, em geral a partir dos 13 ou 18 anos e com consentimento dos pais.[5][6]
Estrangeiros podem usar o BankID?
Somente com um personnummer sueco e uma conta em um banco emissor. A lista de notícias do BankID anuncia a renovação com passaportes da UE para cidadãos não suecos registrados desde 5 de maio de 2026. 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 de identificação eletrônica sueco notificado nos termos do eIDAS em 14 de dezembro de 2020. O sistema está notificado nos níveis substancial e elevado, e a DIGG classifica os meios do BankID no nível substancial e no nível de confiança sueco 3.[10][11]
O BankID basta para a devida diligência de clientes em prevenção à lavagem de dinheiro na Suécia?
É um meio aceito. A lei de prevenção à lavagem de dinheiro, capítulo 3, seção 7, permite usar a identificação eletrônica do eIDAS para verificar a identidade. Triagem, avaliação de risco e monitoramento continuam sendo exigidos além disso.[13]
Quanto tempo leva uma integração com o BankID?
O BankID não publica prazos de onboarding, em 5 de outubro de 2026. Uma integração direta exige um contrato com um banco, um certificado de parte confiante emitido pelo BankID Keygen e o seu próprio tratamento de QR, polling e códigos de dica (hint codes). Um revendedor substitui tudo isso por uma única API.[4][6]
Posso testar o BankID antes de entrar em produção?
Sim. O site para desenvolvedores do BankID tem um portal de testes ao lado da referência da API.[6] Entrar em produção ainda exige um contrato com um banco ou um revendedor e, na via direta, um certificado de parte confiante solicitado pelo BankID Keygen.[4] Teste também o tratamento de códigos de dica desconhecidos, porque o BankID pode adicionar novos sem aviso prévio.[6]
O SverigeID substitui o BankID?
Não. O SverigeID, a e-ID estatal que entra em operação em 1 de dezembro de 2026, é um complemento ao BankID e ao Freja. Está aprovado no nível de confiança sueco 4, mas ainda não consta da lista da UE de sistemas notificados, em 5 de outubro de 2026.[11][17]
Fontes
- BankID em números, BankID, dados de 2025.
- Histórico, BankID.
- Leis e regulamentos, BankID.
- Conecte a sua empresa, BankID.
- Obtenha o BankID, BankID.
- Referência da API /collect, BankID Developers, consultado em 5 de outubro de 2026.
- Reconhecimento facial como controle adicional, notícias do BankID, agosto de 2026.
- Documento de identidade digital no local de votação, notícias do BankID, 2026.
- Notícias, BankID, publicações de 2026.
- Visão geral dos sistemas eID pré-notificados e notificados nos termos do eIDAS, Comissão Europeia, consultado em 5 de outubro de 2026.
- e-IDs aprovadas e funções de atestação, 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 da lei no lagen.nu.
- Regulamento (UE) 2024/1624 (AMLR), artigo 22, EUR-Lex.
- Relatório final, projeto de RTS nos termos do artigo 28(1) do AMLR, AMLA, 30 de setembro de 2026.
- Statlig e-legitimation, SverigeID, Autoridade Policial da Suécia.
Compare cada eID nacional na página de verificação por eID ou comece pelo que é a verificação por eID.
Um único fluxo para a Suécia e além
Comece com o BankID, adicione os eIDs que seus usuários já têm e mantenha os documentos como alternativa.
Artigos relacionados
- e-Devlet para empresas: verificação de identidade na Turquia
- Integração Singpass Myinfo: guia para empresas em Singapura
- Integração com Cl@ve na Espanha: quem pode se conectar e o que usar no lugar
- Verificação PhilSys: como as empresas checam a National ID
- Verificador OpenID4VP: aceitar a carteira europeia de identidade digital (EUDI Wallet)
- Entenda o regulamento eIDAS e as mudanças trazidas pelo eIDAS 2 (2024/1183)