> ## Documentation Index
> Fetch the complete documentation index at: https://docs.didit.me/llms.txt
> Use this file to discover all available pages before exploring further.

# Smart-ID e Mobile-ID: Guia de integração

> Configure a verificação de identidade Smart-ID e Mobile-ID com a Didit: cobertura de países, autenticação por código e atributos.

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](https://docs.didit.me/pt/api-reference/digital-id-wallets/smart-id.md) ou a [API do Mobile-ID](https://docs.didit.me/pt/api-reference/digital-id-wallets/mobile-id.md) 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.

> [!NOTE]
>
> **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](https://docs.didit.me/pt/core-technology/id-verification/digital-id-wallets.md#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](https://docs.didit.me/pt/core-technology/liveness/overview.md) e [Correspondência facial](https://docs.didit.me/pt/core-technology/face-match/overview.md) 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](https://docs.didit.me/pt/console/id-verification-methods.md#ativar-smart-id-ou-mobile-id) para obter o caminho completo na consola.

> [!WARNING]
>
> 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.

```json theme={null}
{
  "EST": {
    "document": { "enabled": true },
    "wallet": {
      "enabled": true,
      "providers": ["smart_id", "mobile_id"],
      "on_failure": "fallback_to_document"
    }
  }
}
```

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](https://docs.didit.me/pt/management-api/workflows/feature-configs.md#ocr-/-verificação-de-identidade).

## Ler o resultado verificado

Leia a sessão concluída através da [API de decisão de sessão](https://docs.didit.me/pt/sessions-api/retrieve-session.md) ou da sua [integração de webhook](https://docs.didit.me/pt/integration/webhooks.md).
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](https://docs.didit.me/pt/reference/data-models.md#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](https://docs.didit.me/pt/getting-started/pricing.md).
Consulte a [tabela de preços de carteiras](https://docs.didit.me/pt/core-technology/id-verification/digital-id-wallets.md#preços) 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](https://docs.didit.me/pt/core-technology/id-verification/digital-id-wallets.md) 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](https://docs.didit.me/pt/core-technology/id-verification/finnish-trust-network.md).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.