> ## 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 a Finnish Trust Network na Finlândia com a Didit: início de sessão bancário, fluxos, resultados verificados e alternativa por documento.

A Finnish Trust Network (FTN) permite que os utilizadores elegíveis verifiquem a sua identidade com uma identidade bancária finlandesa ou um certificado móvel suportado.
Utilize a [API da Finnish Trust Network](https://docs.didit.me/pt/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.
A FTN também funciona dentro do passo de fluxo de **Verificação de identidade** da Didit, utilizando o identificador de carteira `ftn` e o código de país `FIN`.
Para a integração alojada descrita abaixo, utilize os mesmos mecanismos de criação de sessão, resultados de sessão e webhooks que nos seus outros fluxos da Didit.

> [!NOTE]
>
> **A Finnish Trust Network está disponível para a Finlândia.**
> Ative `ftn` nas carteiras aceites do seu fluxo para `FIN`.
> O preço publicado é de **\$0.25 por verificação concluída**.
> Consulte a [cobertura e preços das carteiras](https://docs.didit.me/pt/core-technology/id-verification/digital-id-wallets.md#preços) para todas as carteiras suportadas.

## Percurso do utilizador

1. O utilizador escolhe a Finlândia e a Finnish Trust Network a partir dos métodos de identidade que o seu fluxo aceita.
2. Seleciona um banco aderente ou um certificado móvel suportado.
3. Autentica-se nesse serviço e autoriza a verificação de identidade.
4. Regressa à sessão da Didit, que valida o resultado de identidade e continua o fluxo.

A pessoa precisa de ter uma identidade ativa no serviço que selecionar e de acesso ao respetivo método de autenticação.
Introduz as credenciais bancárias e os códigos de aprovação apenas na experiência de autenticação desse serviço.
A Didit não solicita a palavra-passe bancária no seu formulário de verificação.

Os ecrãs de seleção de método e de retorno da Didit utilizam as definições de imagem de marca e de domínio personalizado da sessão.
O banco ou serviço de identidade selecionado controla os seus próprios ecrãs de autenticação.

## Configurar o fluxo

Abra o passo de **Verificação de identidade** do seu fluxo na consola, escolha **Países** e abra a **Finlândia**.
Em **Carteiras aceitas**, ative a Finnish Trust Network quando estiver disponível.
Mantenha a verificação de documentos ativada se os utilizadores deverem ter a possibilidade de utilizar um documento em alternativa.
Guarde e publique o fluxo antes de criar uma nova sessão.

O fragmento seguinte é uma configuração de `methods`, não um pedido de fluxo completo:

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

Uma carteira indisponível rejeita a gravação do fluxo.
Consulte as [configurações de funcionalidades de fluxos](https://docs.didit.me/pt/management-api/workflows/feature-configs.md#ocr-/-verificação-de-identidade) para o contrato de API completo e a [configuração na consola](https://docs.didit.me/pt/console/id-verification-methods.md) para a configuração visual.

## Resultado verificado

Uma verificação de FTN concluída devolve um resultado de verificação de carteira com garantia `cryptographic`.
A identidade verificada inclui o nome, a data de nascimento e o identificador pessoal do utilizador, caso sejam devolvidos pelo método de identidade selecionado.
A FTN não devolve um retrato.
Inspecione o resultado real em vez de presumir que todos os campos de identidade opcionais estão presentes.

O cartão **Credencial** da sessão mostra a carteira selecionada e a respetiva evidência verificada.
Consulte o [modelo de dados de verificação de identidade](https://docs.didit.me/pt/reference/data-models.md#verificação-de-identidade) para o esquema do resultado.
A autenticação bem-sucedida da FTN conclui o passo de Verificação de identidade; as restantes verificações continuam a determinar a decisão final da sessão.
Mantenha passos separados de prova de vida e comparação facial configurados quando o seu fluxo os exigir.

## Cancelamento e recurso a documento

Se o utilizador cancelar, o pedido expirar ou a verificação falhar, a Didit aplica a definição `wallet.on_failure` do país.
`fallback_to_document` inicia a captura de documentos quando a verificação de documentos estiver ativada para a Finlândia.
`decline` recusa o passo de Verificação de identidade.
Um método de documento desativado não pode servir como recurso.
Para direcionar os utilizadores primeiro para a Finnish Trust Network e mostrar a captura de documentos apenas após uma falha, defina `document.fallback_only` como `true`.
Consulte [Disponibilizar a captura de documentos apenas como recurso](https://docs.didit.me/pt/core-technology/id-verification/verification-methods.md#disponibilizar-a-captura-de-documentos-apenas-como-fallback).

Um redirecionamento ou a apresentação do seletor de bancos não constituem uma verificação de identidade bem-sucedida.
Aguarde pelo resultado verificado da sessão ou pelo webhook antes de conceder acesso.
Processe as entregas duplicadas de webhooks utilizando o mesmo processamento idempotente do restante da sua integração.

## Testar e lançar

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

A FTN custa **\$0.25 por verificação concluída** na tarifa base publicada.
Tentativas de carteira canceladas, expiradas e com falha não incorrem numa cobrança de verificação de carteira concluída.
Um recurso a documento concluído é faturado separadamente de acordo com o preço da verificação de documentos.
Consulte os [preços das carteiras](https://docs.didit.me/pt/core-technology/id-verification/digital-id-wallets.md#preços) para obter as regras de faturação atuais.

## Guias relacionados

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


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