Pular para o conteúdo principal
O login com carteira é um dos três métodos de Verificação de identidade. O usuário faz login com uma identidade digital que já possui, como uma eID nacional ou uma identidade bancária, e esse provedor compartilha com a Didit um conjunto assinado de atributos. O resultado recebe o nível de garantia cryptographic: um provedor de identidade autenticou a pessoa e assinou os atributos que retornou. É só isso que esse nível afirma. Ele não é uma classificação em relação aos outros dois níveis, que descrevem evidências diferentes, e não mais ou menos da mesma coisa. Além disso, o tempo que um login leva depende do fluxo da própria carteira, que a Didit não controla nem garante.
A disponibilidade é específica do seu ambiente. As tabelas abaixo descrevem a disponibilidade em produção, e o console usa o catálogo de recursos disponíveis no respectivo ambiente quando você salva um fluxo de verificação (workflow). MitID, BankID Sweden, iDIN, Finnish Trust Network, Smart-ID e Mobile-ID estão disponíveis. Estonian ID-card, eParaksts mobile, Personalausweis, OneID e ConnectID continuam como Em breve em produção. O Smart-ID oferece suporte à Estônia, Letônia, Lituânia e Bélgica; o Mobile-ID, à Estônia e Lituânia; e o Finnish Trust Network, à Finlândia. Consulte o guia de integração do Smart-ID e do Mobile-ID para ver a cobertura de países, a configuração e o fluxo de verificação. Uma carteira marcada como Em breve não pode ser ativada nesse ambiente.

Escolha sua integração

Use as APIs de carteiras de identidade digital quando sua aplicação gerencia a interface e as etapas de autenticação. Cada carteira tem um endpoint de início dedicado, com endpoints compartilhados de resultado, polling e cancelamento. Você não precisa criar um fluxo. Use a API de sessões para a jornada de carteira hospedada pela Didit, as regras do fluxo e o fallback de documento configurado. A disponibilidade da carteira, a aprovação exigida do usuário e os atributos de identidade verificados se aplicam aos dois métodos de integração.

Pré-requisitos

Cada carteira exige uma identidade ativa junto ao emissor indicado abaixo e acesso ao respectivo método de autenticação. A conta precisa estar habilitada para os atributos solicitados, e o usuário precisa dar consentimento para compartilhá-los. A assinatura verifica o emissor e as declarações retornadas; ela não garante que todos os atributos solicitados estejam presentes, atualizados ou sejam suficientes para a sua política de conformidade. Uma carteira sem foto de rosto não inclui comparação com selfie. As 25 entradas de carteiras do catálogo estão listadas abaixo, incluindo os dois países com BankID, ConnectID, Estonian ID-card e eParaksts mobile. Um fallback de documento configurado executa uma verificação de documento separada. Nenhuma data de lançamento é prometida. Estas são carteiras de identidade. A Triagem de carteiras de criptomoedas verifica endereços de blockchain quanto a risco financeiro e é um produto separado.

Preços

✅ Disponível significa habilitado em produção. ⏳ Em breve significa ainda não habilitado em produção, mesmo que os testes de integração já tenham começado. As carteiras disponíveis aparecem primeiro. Sob solicitação na coluna de preço significa que a carteira está disponível, mas não tem uma tarifa de varejo publicada; não significa verificação gratuita. Estes são os preços padrão da Didit em USD por verificação de carteira concluída para os produtos de identidade listados abaixo. O preço listado inclui a verificação de identidade da carteira; nenhuma tarifa separada de transação de eID nacional é acrescentada a ele. Uma tarifa acordada especificamente para a organização tem precedência. Em breve na coluna de preço significa que a carteira está planejada e que o preço para o cliente ainda não foi publicado. Não significa que a verificação é gratuita. As bandeiras dos países mostram a cobertura da carteira no catálogo; a coluna de disponibilidade, separada, mostra se ela pode ser ativada no momento. Um preço publicado não ativa uma carteira. A disponibilidade acima vem do catálogo de produção. Uma carteira marcada como Em breve ainda não pode ser selecionada em um fluxo; estas tarifas se aplicam quando ela ficar disponível.
  • Um login verificado com carteira é cobrado uma vez por nó de Verificação de identidade em um fluxo, ou uma vez por requisição de verificação pela API de carteira independente. Callbacks repetidos ou consultas de status não geram outra cobrança.
  • Logins cancelados, expirados, recusados ou incompletos não geram cobrança de verificação por carteira.
  • Os preços das carteiras são preços de tabela: o desconto do seu plano se aplica a eles como a qualquer outra verificação.
  • Um fallback de documento é uma verificação separada, cobrada conforme os preços de verificação de documentos. Os demais recursos concluídos do fluxo são cobrados separadamente.
Por exemplo, 1.000 verificações de identificação completa com iDIN concluídas na tarifa padrão custam $950, sem contar os demais recursos do fluxo. Trata-se de identificação completa; não é um preço de login recorrente. A tarifa do BankID acima é para Norway High, e a tarifa do eID alemão é para o Personalausweis Profile 2.

O que o usuário faz

  1. Escolhe o país na etapa de identidade e seleciona uma carteira entre as que você aceita.
  2. Faz login com essa carteira, do mesmo jeito que entra no banco ou no portal do governo.
  3. Aprova o compartilhamento dos seus atributos de identidade com você.
  4. Volta verificado.
O login no mesmo dispositivo leva o usuário ao app da carteira e o traz de volta ao fluxo de verificação quando ele termina. O login entre dispositivos exibe um QR code na tela do computador, que ele escaneia com o celular onde está a carteira. Os dois modos são oferecidos quando a carteira os suporta; o usuário escolhe. Quando o Smart-ID ou o Mobile-ID está ativado no seu fluxo, o usuário informa o código de identificação pessoal na página de verificação. O Mobile-ID também pede o número de telefone associado à identidade. A página exibe um código de comparação, e o usuário aprova no celular somente quando esse código for igual ao exibido no celular. O usuário digita o PIN no próprio celular; a Didit nunca o solicita. Esse fluxo funciona em um computador ou celular, sem QR code. A disponibilidade é determinada pelo catálogo de capacidades em produção; uma carteira marcada como Em breve ainda não pode ser ativada. Um login iniciado permanece válido por um período limitado (10 minutos por padrão). Depois disso, o usuário precisa iniciá-lo novamente.

As carteiras são uma lista de aceitação

wallet.providers é a lista de carteiras que um país pode oferecer. Não é uma classificação: a ordem que você envia não tem significado, é normalizada para a ordem do catálogo ao salvar, e o usuário final escolhe entre as que você aceitou. Ative uma carteira ou todas as carteiras de um país: a escolha é dele. A API rejeita um fluxo que ative uma carteira que o catálogo não oferece naquele país, ou uma que ainda esteja como Coming soon.
A lista de atributos de cada carteira abaixo inclui uma asserção assinada. A Didit verifica essa assinatura e informa o resultado como wallet_verification.signature_valid na sessão; a asserção em si não é devolvida, então não há referência para buscar ou armazenar. A coluna Na sessão indica qual dos dois você recebe para cada atributo.

Carteiras compatíveis

As carteiras disponíveis são MitID, BankID Sweden, iDIN, Finnish Trust Network, Smart-ID e Mobile-ID. O iDIN está disponível para identificação completa nos Países Baixos. Smart-ID e Mobile-ID estão disponíveis nos países listados no catálogo abaixo. A cobertura de países e os dados solicitados para Smart-ID e Mobile-ID refletem a integração implementada; a disponibilidade em produção continua sendo controlada separadamente. Use o guia de integração para as rotas de Smart-ID e Mobile-ID implementadas.
A Disponibilidade é fornecida pelo catálogo de capacidades, e não mantida manualmente aqui. Em breve significa que a carteira aparece no console, mas ainda não pode ser ativada; não há data confirmada.

Cartão de identidade estoniano e eParaksts mobile

Os dois métodos já estão integrados ao catálogo de carteiras, mas continuam como Em breve em produção. Eles não podem ser ativados em fluxos de produção até que o catálogo de produção os marque como Disponível. Os identificadores de API são idcard_ee para a Estônia (EST) e eparaksts_mobile para a Letônia (LVA). Os dois custam $0.55 por verificação concluída quando estiverem disponíveis; um preço publicado não libera o acesso em produção.
  • Cartão de identidade estoniano: o usuário continua no navegador do computador conectado ao leitor de cartões inteligentes e se autentica com o cartão e o PIN por meio do software do cartão.
  • eParaksts mobile: o usuário acessa o serviço de autenticação de identidade e aprova a solicitação usando sua conta ativa do eParaksts mobile. Quem está no desktop pode escanear o QR code para continuar no celular; quem está no celular continua diretamente.
Os dois usam o mesmo fluxo da Didit de seleção de carteira, redirecionamento e retorno. O usuário digita o PIN de autenticação apenas no serviço de identidade ou no software do cartão, nunca em um formulário da Didit. Após a autenticação, a Didit verifica os atributos de identidade assinados e dá continuidade ao fluxo configurado. Em caso de cancelamento ou falha, aplica-se o fallback de documento ou a ação de recusa configurados no fluxo.
A marca própria se aplica às telas de verificação da Didit. As telas externas de autenticação desses dois métodos mantêm a identidade visual do respectivo serviço. Logos personalizados, nomes de serviço e estilos de marca própria não são aplicados a essas telas externas.

Use essas carteiras pela API

Os dois métodos também permitem verificação avulsa pela API, sem workflow_id. A disponibilidade em produção é a mesma para a API avulsa e para os fluxos; consulte GET /v3/id-verification/wallets/ antes de oferecer qualquer um dos métodos aos usuários. Mantenha sua x-api-key no seu backend e registre o host de retorno da sua aplicação na configuração allowed_return_hosts da aplicação. Envie uma return_url HTTPS nesse host ao iniciar uma verificação. A resposta de início retorna um request_id e uma wallet_verification.next_action.url para o navegador do usuário. Redirecione o usuário para essa URL para que ele se autentique com o cartão ou o aplicativo. Quando ele voltar, consulte GET /v3/id-verification/wallets/verifications/{request_id}/ a partir do seu backend para conferir o resultado da verificação, ou processe o webhook assinado status.updated. Não considere o redirecionamento do navegador, por si só, como prova de que a verificação foi bem-sucedida. O mesmo preço e as mesmas regras de faturamento por verificação concluída valem para as duas opções de integração.

Google Wallet

O Google Wallet permite que uma pessoa compartilhe, pelo celular, um documento de identidade emitido pelo governo com a sua página ou aplicativo, por meio da W3C Digital Credentials API. Ele estará disponível em breve em produção: aplicações de sandbox e o ambiente de staging já funcionam hoje, e a produção aguarda a aprovação do Google.
  • Países: Estados Unidos, Reino Unido, Brasil, Singapura e Taiwan.
  • Credenciais: o ID pass do Google Wallet criado a partir de um passaporte, além de carteiras de motorista digitais de estados dos EUA compatíveis.
  • Dados retornados: nome, data de nascimento, número do documento, data de validade do documento, país emissor e autoridade emissora e, no caso de um ID pass, a nacionalidade. O resultado também traz o veredito signature_valid da credencial. Nenhuma foto é compartilhada.
  • Privacidade: a Didit solicita apenas os campos de que precisa, e apenas esses campos saem da carteira. A pessoa aprova o compartilhamento no Google Wallet, no próprio dispositivo.
Não há redirecionamento: a pessoa confirma no prompt de carteira do próprio navegador ou do Android, e os navegadores de desktop exibem o próprio QR code quando a carteira está em um celular. A verificação é solicitada a partir da sua página ou aplicativo, por isso a integração via API precisa da origem HTTPS da sua página. O fluxo hospedado da Sessions API oferece o método apenas em navegadores e dispositivos compatíveis e, nos demais, mantém o fallback de documento. Ao exibir o fluxo hospedado dentro da sua própria página, use o Web SDK 0.5.1 ou posterior, ou adicione digital-credentials-get ao atributo allow do seu iframe: sem isso, o navegador recusa a solicitação à carteira dentro do iframe.

Outras carteiras em breve

O ConnectID (Austrália) está integrado para testes em sandbox e aparece no catálogo de carteiras como connectid. A pessoa escolhe um banco de teste participante no seletor do ConnectID, faz login nesse banco e revisa a solicitação de compartilhamento. O pacote inicial de identidade solicita nome, sobrenome e data de nascimento, com uma referência de transação para a verificação. Ele não solicita endereço, número de telefone, endereço de e-mail, saldo da conta nem histórico de transações. O aviso de compartilhamento identifica a Didit e a empresa que recebe a identidade verificada. As credenciais bancárias permanecem com o banco. O acesso à produção continua marcado como Em breve; os testes em sandbox não ativam a verificação de identidade em produção. Um caso de uso aprovado para produção, o onboarding do cliente, os termos exigidos e a certificação precisam ser concluídos antes da ativação. As demais carteiras marcadas como Em breve nas tabelas também continuam indisponíveis em produção. Nenhuma data de lançamento é prometida.

Nível de garantia

Quando uma carteira fornece um nível de garantia eIDAS (low, substantial ou high), a Didit registra no resultado o nível efetivamente declarado. Uma carteira sem um nível eIDAS especificado, como a ConnectID, aparece como Not specified; a integração dela não implica nenhuma declaração de garantia eIDAS. Se uma carteira retornar um nível inferior do que o solicitado, o login falha em vez de ser rebaixado silenciosamente. Verifique wallet_verification.level_of_assurance na sessão quando suas regras de conformidade dependerem dele.

Referência por carteira

MitID

mitid · Disponível Informações inseridas no Didit: Nome · Data de nascimento · Alias CPR (pseudonimizado)

BankID

bankid_se · Disponível Informações inseridas no Didit: Nome · Número pessoal

iDIN

idin · Disponível Informações inseridas no Didit: Nome · Data de nascimento · Endereço

Finnish Trust Network

ftn · Disponível Informações inseridas no Didit: Nome · Código de identidade pessoal

Smart-ID

smart_id · Disponível Informações inseridas no Didit: Código de identificação pessoal

Mobile-ID

mobile_id · Disponível Informações inseridas no Didit: Código de identificação pessoal · Número de telefone do Mobile-ID

BankID

bankid_no · Em breve Informações inseridas no Didit: Nome · Data de nascimento · Número de identidade nacional

Vipps

vipps · Em breve Informações inseridas no Didit: Nome · Data de nascimento · Número de identidade nacional

Buypass ID

buypass · Em breve Informações inseridas no Didit: Nome · Data de nascimento · Número de identidade nacional

itsme

itsme · Em breve Informações inseridas no Didit: Nome · Data de nascimento · Número do registro nacional

Personalausweis

personalausweis · Em breve Informações inseridas no Didit: Nome · Data de nascimento · Nacionalidade · Endereço

Freja eID

frejaid · Em breve Informações inseridas no Didit: Nome · Data de nascimento · Número pessoal

UAE PASS

uae_pass · Em breve Informações inseridas no Didit: Nome · Número do Emirates ID · Nacionalidade · Retrato

gov.br

govbr · Em breve Informações inseridas no Didit: Nome · CPF

OneID

oneid · Em breve Informações inseridas no Didit: Nome · Data de nascimento

Google Wallet

google_wallet · Em breve Informações inseridas no Didit: Nenhum dado de identidade inserido no Didit

GOV.UK Wallet

govuk_wallet · Em breve Informações inseridas no Didit: Nome · Data de nascimento · Retrato

Cartão de identidade estoniano

idcard_ee · Em breve Informações inseridas no Didit: Nome · Data de nascimento · Código de identificação pessoal

eParaksts mobile

eparaksts_mobile · Em breve Informações inseridas na Didit: Nome · Data de nascimento · Código de identificação pessoal

Bank iD

bankid_cz · Em breve Informações inseridas na Didit: Nome · Data de nascimento

MojeID

mojeid · Em breve Informações inseridas na Didit: Nome · Data de nascimento

Diia

diia · Em breve Informações inseridas na Didit: Nome · Data de nascimento · Retrato

FranceConnect

franceconnect · Em breve Informações inseridas na Didit: Nome · Data de nascimento

Auðkenni

audkenni · Em breve Informações inseridas na Didit: Nome · Kennitala

ConnectID

connectid · Em breve Informações inseridas na Didit: Nenhum dado de identidade é inserido na Didit

EUDI Wallet

eudi · Em breve Informações inseridas na Didit: PID - dados de identificação pessoal

Falha e alternativa

Qualquer resultado diferente de verified segue a opção wallet.on_failure do país: fallback_to_document envia o usuário para a captura de documento, e decline encerra a sessão com uma Verificação de identidade recusada. Com fallback_to_document e a captura de documento desativada para esse país, a sessão é recusada, porque não há para onde recorrer. Para mostrar a captura de documento apenas após um login na carteira com falha, consulte Oferecer a captura de documento apenas como alternativa. Somente um login concluído é cobrado. Logins abandonados, cancelados, expirados e com falha não têm custo.

O que chega à sessão

attributes contém as claims validadas da carteira, cujos nomes variam conforme a carteira. Use full_name e date_of_birth no resultado da verificação de identidade para os campos de identidade normalizados. A tabela por carteira diferencia esses campos normalizados dos atributos específicos de cada carteira. portrait está presente apenas nas carteiras que compartilham um retrato. signature_valid é o resultado da validação da asserção assinada que a carteira retornou. Ele é true em um login concluído: uma asserção que não é validada faz o login falhar e segue wallet.on_failure em vez de produzir um resultado aprovado. Os tipos completos dos campos estão no modelo de dados da verificação de identidade.

Configuração das carteiras

Este é um fragmento de configuração para usar somente quando o catálogo do seu ambiente marca todas as carteiras selecionadas como available no país selecionado. Enviar uma carteira indisponível rejeita o salvamento de todo o fluxo, incluindo quaisquer outros métodos na mesma requisição. Para exemplos de Smart-ID e Mobile-ID, consulte o guia de integração.
Ative pelo menos uma carteira quando wallet.enabled for true, ou o salvamento será rejeitado. A referência completa está em Configurações de recursos do fluxo.

Relacionados

Última modificação em 1 de novembro de 2026