Pular para o conteúdo principal
O Smart-ID e o Mobile-ID permitem que os usuários verifiquem a identidade aprovando uma requisição no celular. Use a API do Smart-ID ou a API do Mobile-ID para iniciar a verificação a partir da sua própria aplicação, sem um workflow. Os dois métodos também funcionam dentro da etapa ID Verification do fluxo da Didit e retornam um resultado de verificação de carteira com nível de garantia cryptographic. Para a integração com o fluxo hospedado descrita abaixo, use a mesma criação de sessão e a mesma integração de webhook dos seus outros fluxos da Didit.
O Smart-ID e o Mobile-ID estão disponíveis. O Smart-ID é compatível com Estônia, Letônia, Lituânia e Bélgica. O Mobile-ID é compatível com Estônia e Lituânia. Selecione no console as carteiras que o seu fluxo aceita para cada país. Consulte cobertura e preços das carteiras para ver a lista completa.

​
Países e pré-requisitos

A integração cobre o Smart-ID na Estônia (EST), Letônia (LVA), Lituânia (LTU) e Bélgica (BEL). O Mobile-ID cobre a Estônia (EST) e a Lituânia (LTU). O Mobile-ID não é oferecido para a Letônia. Esses códigos de país descrevem as rotas integradas. Eles não garantem que todas as rotas estejam ativadas no seu ambiente. Para o Smart-ID, o usuário precisa de uma identidade Smart-ID ativa e elegível, do código de identificação pessoal correspondente e de acesso ao aplicativo. Para o Mobile-ID, o usuário precisa de uma identidade Mobile-ID ativa, do código de identificação pessoal correspondente e do número de telefone associado. Informe o número de telefone do Mobile-ID no formato internacional: +372 para a Estônia ou +370 para a Lituânia. O país selecionado deve corresponder à identidade utilizada. Nenhum dos dois métodos retorna uma foto de rosto. Se o seu fluxo exigir uma selfie, mantenha as etapas de Prova de vida e Correspondência facial adequadas configuradas separadamente.

​
O que o usuário vê

  1. O usuário seleciona o país e escolhe Smart-ID ou Mobile-ID entre as carteiras que o seu fluxo aceita.
  2. A sessão de verificação solicita o código de identificação pessoal. O Mobile-ID também solicita o número de telefone associado.
  3. A página exibe um código de comparação enquanto a requisição de autenticação chega ao celular.
  4. O usuário confere se o código no celular corresponde ao código na página de verificação e, em seguida, aprova com o PIN no celular.
  5. A Didit valida o resultado de identidade assinado e dá continuidade ao fluxo de verificação.
O formulário de identidade e a tela do código de comparação usam o mesmo layout dos outros métodos de verificação. Quando a personalização de marca própria está ativada, eles herdam as cores, a tipografia, o estilo dos botões e o logotipo do cliente definidos na sessão, e permanecem no domínio da sessão. Atualizar a página restaura o código de comparação ativo sem iniciar outra requisição de aprovação. O usuário nunca digita o PIN da carteira na página de verificação. Se os códigos forem diferentes ou se o usuário não tiver iniciado a requisição, ele deve cancelá-la. O fluxo com código de comparação funciona em navegadores de computador ou de celular e não exige QR code. A página aguarda o resultado automaticamente e oferece uma opção de cancelamento. Uma aprovação no celular ainda precisa passar pelas verificações de identidade e de assinatura antes que a Didit considere a verificação da carteira bem-sucedida.

​
Configurar o fluxo

No console, abra o nó ID Verification do seu fluxo, escolha Countries e abra o país que você deseja configurar. Em Wallets accepted, selecione as carteiras disponíveis e escolha o comportamento em caso de falha. Salve e publique o fluxo antes de criar uma nova sessão. Consulte métodos de Verificação de identidade no console para ver o caminho completo no console.
O trecho a seguir é um fragmento da configuração methods, não uma requisição completa de fluxo. Use-o somente quando smart_id e mobile_id estiverem ambos marcados como available para a Estônia no seu ambiente. Uma carteira indisponível faz com que o salvamento de todo o fluxo seja rejeitado.
O array providers é uma lista de permissões: os usuários escolhem entre as carteiras dela, e a ordem do array não define uma carteira preferencial. Para a Lituânia, use LTU com os mesmos identificadores de carteira quando ambas estiverem disponíveis. Para a Letônia ou a Bélgica, use LVA ou BEL somente com smart_id, desde que passe pela mesma verificação de disponibilidade. Os países omitidos mantêm o comportamento padrão atual de captura de documentos. O contrato completo de configuração está em Configurações de recursos do fluxo.

​
Ler o resultado verificado

Leia a sessão concluída pela API de decisão da sessão ou pela sua integração de webhook. Uma verificação de carteira bem-sucedida registra verification_method: "wallet", assurance: "cryptographic" e wallet_provider: "smart_id" ou "mobile_id". O objeto wallet_verification identifica a carteira, o país emissor, o horário da verificação, o nível de garantia e o veredito da assinatura. O resultado da verificação de identidade expõe os campos normalizados full_name e date_of_birth. Para essas duas carteiras, wallet_verification.attributes contém given_name, family_name, birthdate e personal_code da identidade validada. O país emissor identifica a rota de identidade. Ele não comprova a nacionalidade da pessoa. A Didit retorna o veredito da assinatura, não a asserção assinada subjacente. Nenhum retrato nem PIN da carteira é retornado. No console, o card Credential da sessão mostra a carteira e as evidências verificadas. Uma verificação de carteira bem-sucedida conclui a etapa de Verificação de identidade. As verificações posteriores do seu fluxo continuam determinando a decisão final da sessão. Consulte o modelo de dados da verificação de identidade para ver os tipos de campo e a diferença entre o resultado de uma verificação e a decisão geral da sessão.

​
Lidar com cancelamento e falha

Se um usuário cancelar, exceder o tempo limite ou não conseguir concluir a autenticação, a Didit aplica a configuração wallet.on_failure do país. fallback_to_document inicia a captura de documento quando ela está habilitada para esse país. decline recusa a etapa de Verificação de identidade. Se a captura de documento estiver desabilitada, não há fallback para documento disponível. Somente uma verificação de carteira concluída e verificada gera a cobrança de verificação de carteira. Tentativas de carteira canceladas, expiradas e com falha não geram cobrança. Uma alternativa por documento concluída é uma verificação separada, cobrada conforme os preços de verificação de documentos. Consulte a tabela de preços de carteiras para ver as tarifas publicadas; um método sem tarifa publicada não deve ser considerado gratuito.

​
Testar antes da produção

Teste cada carteira e cada país que você pretende oferecer no ambiente em que estão habilitados. Confirme que as carteiras corretas aparecem, que o código de comparação fica visível, que a aprovação dá continuidade ao fluxo e que o resultado da sessão contém as evidências de carteira esperadas. Verifique também o cancelamento, a expiração e o comportamento alternativo que você escolheu. Simulações em sandbox e testes em staging são diferentes da autenticação em produção. Uma aprovação simulada é útil para verificar sua integração, mas não comprova que uma identidade real consegue se autenticar em produção. Antes da implantação, confirme a disponibilidade em produção no console e conclua uma verificação autorizada em um dispositivo real para a rota que você pretende usar.

​
Outras carteiras de identidade digital

O catálogo de carteiras de identidade digital da Didit inclui a disponibilidade em produção e as carteiras previstas, incluindo a Finnish Trust Network, já disponível, e as próximas integrações com BankID e EUDI Wallet. Uma carteira listada, um preço publicado ou um formulário de onboarding concluído não habilita, por si só, a autenticação em produção. Use o catálogo e o console do seu ambiente para determinar o que você pode ativar hoje. Veja também Finnish Trust Network na Finlândia.
Última modificação em 1 de novembro de 2026