> ## 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 com Smart-ID e Mobile-ID na Didit: cobertura por país, código de comparação, atributos verificados e fallback.

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

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

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

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

## Ler o resultado verificado

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


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