> ## 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.

# Finnish Trust Network (FTN): guia de integração

> Configure com a Didit a verificação FTN na Finlândia: login bancário, configuração do fluxo, resultados verificados e documento como alternativa.

Finnish Trust Network (FTN) permite que usuários elegíveis verifiquem sua identidade com uma identidade bancária finlandesa ou um certificado móvel compatível.
Use a [API do Finnish Trust Network](https://docs.didit.me/pt-br/api-reference/digital-id-wallets/ftn.md) para iniciar a autenticação bancária a partir da sua própria aplicação, sem um fluxo de verificação (workflow).
O FTN também funciona dentro da etapa **ID Verification** do fluxo da Didit, com o identificador de carteira `ftn` e o código de país `FIN`.
Na integração hospedada descrita abaixo, use a mesma criação de sessão, os mesmos resultados de sessão e os mesmos webhooks dos seus outros fluxos da Didit.

> [!NOTE]
>
> **O Finnish Trust Network está disponível na Finlândia.**
> Ative `ftn` nas carteiras aceitas do seu fluxo para `FIN`.
> O preço publicado é **\$0.25 por verificação concluída**.
> 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 todas as carteiras compatíveis.

## Jornada do usuário

1. O usuário escolhe a Finlândia e a Finnish Trust Network entre os métodos de identidade que o seu fluxo aceita.
2. Ele seleciona um banco participante ou um certificado móvel compatível.
3. Ele se autentica nesse serviço e autoriza a verificação de identidade.
4. Ele volta para a sessão da Didit, que valida o resultado de identidade e dá continuidade ao fluxo.

A pessoa precisa ter uma identidade ativa no serviço que selecionar e acesso ao método de autenticação desse serviço.
Ela digita as credenciais bancárias e os códigos de aprovação somente na experiência de autenticação desse serviço.
A Didit não pede a senha do banco no formulário de verificação.

As telas de escolha de método e de retorno da Didit usam as configurações de branding e de domínio personalizado da sessão.
O banco ou serviço de identidade selecionado controla as próprias telas de autenticação.

## Configurar o fluxo

Abra a etapa **Verificação de identidade** do seu fluxo no console, escolha **Países** e abra **Finland**.
Em **Carteiras aceitas**, ative a Finnish Trust Network quando estiver disponível.
Mantenha a verificação de documentos ativada se os usuários puderem usar um documento como alternativa.
Salve e publique o fluxo antes de criar uma nova sessão.

O trecho a seguir é um fragmento de configuração de `methods`, não uma requisição completa de fluxo:

```json theme={null}
{
  "FIN": {
    "document": { "enabled": true },
    "wallet": {
      "enabled": true,
      "providers": ["ftn"],
      "on_failure": "fallback_to_document"
    }
  }
}
```

Uma carteira indisponível impede que o fluxo seja salvo.
Consulte [configurações de recursos do fluxo](https://docs.didit.me/pt-br/management-api/workflows/feature-configs.md#ocr-/-verificação-de-identidade) para ver o contrato completo da API e [configuração no console](https://docs.didit.me/pt-br/console/id-verification-methods.md) para a configuração visual.

## Resultado verificado

Uma verificação FTN concluída retorna um resultado de verificação de carteira com nível de garantia `cryptographic`.
A identidade verificada inclui o nome, a data de nascimento e o identificador pessoal do usuário, quando retornados pelo método de identidade selecionado.
O FTN não retorna uma foto de rosto.
Examine o resultado real em vez de presumir que todos os campos de identidade opcionais estão presentes.

O cartão **Credential** da sessão mostra a carteira selecionada e as evidências verificadas.
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 o esquema do resultado.
Uma autenticação FTN bem-sucedida conclui a etapa Verificação de identidade; as verificações restantes ainda determinam a decisão final da sessão.
Mantenha configuradas etapas separadas de prova de vida e de comparação facial quando o seu fluxo exigir.

## Cancelamento e alternativa por documento

Se o usuário cancelar, a requisição expirar ou a verificação falhar, a Didit aplica a configuração `wallet.on_failure` do país.
`fallback_to_document` inicia a captura de documento quando a verificação de documentos está ativada para a Finlândia.
`decline` recusa a etapa Verificação de identidade.
Um método de documento desativado não pode servir como alternativa.
Para encaminhar os usuários primeiro para a Finnish Trust Network e mostrar a captura de documento somente após uma falha, defina `document.fallback_only` como `true`.
Consulte [Oferecer a captura de documento apenas como alternativa](https://docs.didit.me/pt-br/core-technology/id-verification/verification-methods.md#oferecer-a-captura-de-documento-apenas-como-fallback).

Um redirecionamento ou a exibição da tela de escolha de banco não é uma verificação de identidade bem-sucedida.
Aguarde o resultado verificado da sessão ou o webhook antes de conceder acesso.
Trate entregas duplicadas de webhook com o mesmo processamento idempotente usado no restante da sua integração.

## Testar e lançar

Teste a carteira no ambiente em que ela está ativada.
Teste o retorno bem-sucedido, o cancelamento pelo usuário, a expiração, a identidade incompleta e o fallback de documento.
Teste também os dispositivos e os contextos de navegador de que seus usuários dependem.
Um resultado simulado no sandbox não comprova uma autenticação bancária real nem a ativação em produção.

O FTN custa **\$0.25 por verificação concluída** na tarifa base publicada.
Tentativas de carteira canceladas, expiradas e com falha não geram cobrança de verificação de carteira concluída.
Um fallback de documento concluído é cobrada separadamente, conforme os preços da verificação de documentos.
Consulte [preços da carteira](https://docs.didit.me/pt-br/core-technology/id-verification/digital-id-wallets.md#preços) para ver as regras de faturamento atuais.

## Guias relacionados

* [Cobertura e preços das carteiras de identidade digital](https://docs.didit.me/pt-br/core-technology/id-verification/digital-id-wallets.md)
* [Integração com Smart-ID e Mobile-ID](https://docs.didit.me/pt-br/core-technology/id-verification/smart-id-mobile-id.md)
* [Métodos de verificação de identidade](https://docs.didit.me/pt-br/core-technology/id-verification/verification-methods.md)
* [Integração de webhooks](https://docs.didit.me/pt-br/integration/webhooks.md)


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