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.
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.
O que o usuário faz
- Escolhe o país na etapa de identidade e seleciona uma carteira entre as que você aceita.
- Faz login com essa carteira, do mesmo jeito que entra no banco ou no portal do governo.
- Aprova o compartilhamento dos seus atributos de identidade com você.
- Volta verificado.
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ãoidcard_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.
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, semworkflow_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_validda 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.
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 comoconnectid.
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 comoavailable 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.
wallet.enabled for true, ou o salvamento será rejeitado. A referência completa está em Configurações de recursos do fluxo.
Relacionados
- Integração com a Finnish Trust Network - Finlândia, autenticação bancária e alternativa com documento
- Integração com Smart-ID e Mobile-ID - cobertura por país, códigos de comparação e configuração do fluxo
- Métodos de Verificação de identidade — os três métodos, alternativa e faturamento
- Consulta sem documento — o método de correspondência de dados
- Métodos de Verificação de identidade no console — ativação de carteiras por país