Saltar para o conteúdo principal
O Smart-ID e o Mobile-ID permitem que os utilizadores verifiquem a sua identidade aprovando um pedido no respetivo telemóvel. Utilize 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 fluxo. Ambos os métodos também funcionam dentro do passo de fluxo de Verificação de identidade da Didit, devolvendo um resultado de verificação de carteira com garantia cryptographic. Para a integração de fluxo alojada descrita abaixo, utilize a mesma criação de sessão e integração de webhook que utiliza nos seus outros fluxos da Didit.
O Smart-ID e o Mobile-ID estão disponíveis. O Smart-ID suporta a Estónia, Letónia, Lituânia e Bélgica. O Mobile-ID suporta a Estónia e a Lituânia. Selecione na consola as carteiras que o seu fluxo aceita para cada país. Consulte a cobertura de carteiras e preços para ver a lista completa.

​
Países e pré-requisitos

A integração abrange o Smart-ID na Estónia (EST), Letónia (LVA), Lituânia (LTU) e Bélgica (BEL). O Mobile-ID abrange a Estónia (EST) e a Lituânia (LTU); o Mobile-ID não é disponibilizado para a Letónia. Estes códigos de país descrevem as rotas integradas, não constituindo uma garantia de que todas as rotas estejam ativadas no seu ambiente. Para o Smart-ID, o utilizador necessita de uma identidade Smart-ID elegível e ativa, do respetivo código de identificação pessoal e de acesso à aplicação. Para o Mobile-ID, o utilizador necessita de uma identidade Mobile-ID ativa, do respetivo código de identificação pessoal e do número de telefone associado. Introduza 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 que está a ser utilizada. Nenhum dos métodos devolve uma fotografia de rosto. Se o seu fluxo exigir uma selfie, mantenha os passos adequados de Prova de vida e Correspondência facial configurados separadamente.

​
O que o utilizador vê

  1. O utilizador seleciona o seu país e escolhe Smart-ID ou Mobile-ID de 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 apresenta um código de comparação enquanto o pedido de autenticação é enviado para o telemóvel.
  4. O utilizador verifica se o código no telemóvel coincide com o código na página de verificação e, em seguida, aprova utilizando o seu PIN no telemóvel.
  5. A Didit valida o resultado de identidade assinado e prossegue com o fluxo de verificação.
O formulário de identidade e o ecrã com o código de comparação utilizam o mesmo esquema que os restantes métodos de verificação. Quando a personalização de marca branca está ativada, herdam as cores, tipografia, estilo dos botões e o logótipo do cliente da sessão, permanecendo no domínio da sessão. Atualizar a página restaura o código de comparação ativo sem iniciar outro pedido de aprovação. O utilizador nunca introduz o PIN da sua carteira na página de verificação. Se os códigos forem diferentes ou se o utilizador não tiver iniciado o pedido, este deve cancelá-lo. O fluxo de código de comparação funciona num navegador de computador ou telemóvel e não requer um código QR. A página aguarda pelo resultado automaticamente e disponibiliza uma opção de cancelamento. Uma aprovação no telemóvel deve ainda passar pelas verificações de identidade e de assinatura antes de a Didit considerar a verificação da carteira bem-sucedida.

​
Configurar o fluxo

Na consola, abra o nó de Verificação de identidade do seu fluxo, selecione Países e abra o país que pretende configurar. Em Carteiras aceites, selecione as carteiras disponíveis e escolha o comportamento em caso de falha. Guarde e publique o fluxo antes de criar uma nova sessão. Consulte os métodos de Verificação de identidade na consola para obter o caminho completo na consola.
O seguinte é um fragmento de configuração de methods, e não um pedido de fluxo completo. Utilize-o apenas quando ambos os identificadores smart_id e mobile_id estiverem marcados como available para a Estónia no seu ambiente. Uma carteira indisponível impede guardar todo o fluxo.
O array providers é uma lista de aceitação: os utilizadores escolhem entre as suas carteiras, e a ordem do array não define uma carteira preferencial. Para a Lituânia, utilize LTU com os mesmos identificadores de carteira quando ambos estiverem disponíveis. Para a Letónia ou Bélgica, utilize LVA ou BEL apenas com smart_id, sujeito à mesma verificação de disponibilidade. Os países omitidos mantêm o seu comportamento predefinido existente de captura de documentos. O contrato de configuração completo encontra-se em Configurações de funcionalidades de fluxos.

​
Ler o resultado verificado

Leia a sessão concluída através da API de decisão de sessão ou da sua integração de webhook. Uma verificação de carteira bem-sucedida regista verification_method: "wallet", assurance: "cryptographic" e wallet_provider: "smart_id" ou "mobile_id". O objeto wallet_verification identifica a carteira, o país emissor, a hora da verificação, o nível de garantia e o veredicto da assinatura. O resultado da verificação de identidade disponibiliza os campos normalizados full_name e date_of_birth. Para estas duas carteiras, wallet_verification.attributes inclui given_name, family_name, birthdate e personal_code da identidade validada. O país emissor identifica a rota da identidade; não determina a nacionalidade da pessoa. A Didit devolve o veredicto da assinatura, e não a asserção assinada subjacente. Não é devolvida nenhuma fotografia de rosto nem PIN de carteira. Na consola, o cartão Credencial da sessão mostra a carteira e as respetivas evidências verificadas. Uma verificação de carteira bem-sucedida conclui o passo de Verificação de identidade; as verificações posteriores no seu fluxo continuam a determinar a decisão final da sessão. Consulte o modelo de dados de verificação de identidade para conhecer os tipos de campos e a distinção entre o resultado de uma verificação e a decisão global da sessão.

​
Lidar com cancelamentos e falhas

Se um utilizador cancelar, exceder o tempo limite ou não conseguir concluir a autenticação, a Didit aplica a definição wallet.on_failure do país. fallback_to_document inicia a captura de documentos quando esta estiver ativada para esse país. decline recusa o passo de Verificação de identidade. Se a captura de documentos estiver desativada, não existe fallback para documento disponível. Apenas uma verificação de carteira concluída e verificada está sujeita à cobrança de verificação por carteira. As tentativas de carteira canceladas, expiradas ou com falha não têm custos. Um fallback para documento concluído constitui uma verificação separada ao abrigo dos preços de verificação de documentos. Consulte a tabela de preços de carteiras para conhecer as tarifas publicadas; um método sem uma tarifa publicada não deve ser considerado gratuito.

​
Testar antes da produção

Teste cada carteira e país que planeia disponibilizar no ambiente onde estiverem ativados. Confirme que são apresentadas as carteiras corretas, que o código de comparação é visível, que a aprovação dá continuidade ao fluxo e que o resultado da sessão contém a evidência de carteira esperada. Verifique também o cancelamento, a expiração e o comportamento de fallback escolhido. As simulações em sandbox e os testes de staging são diferentes da autenticação em produção. Uma aprovação simulada é útil para verificar a sua integração, mas não comprova que uma identidade real consiga autenticar-se em produção. Antes do lançamento, confirme a disponibilidade em produção na consola e conclua uma verificação autorizada num dispositivo real para o percurso que pretende utilizar.

​
Outras carteiras de identidade digital

O catálogo de carteiras de identidade digital da Didit inclui a disponibilidade em produção e futuras carteiras, incluindo a Finnish Trust Network, já disponível, e as futuras integrações com BankID e EUDI Wallet. Uma carteira listada, um preço publicado ou um formulário de onboarding preenchido não ativam, por si só, a autenticação em produção. Utilize o catálogo e a consola do seu ambiente para determinar o que pode ativar hoje. Consulte também Finnish Trust Network para a Finlândia.
Última modificação em 7 de novembro de 2026