Pular para o conteúdo principal
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 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.
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 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:
Uma carteira indisponível impede que o fluxo seja salvo. Consulte configurações de recursos do fluxo para ver o contrato completo da API e configuração no console 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 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. 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 para ver as regras de faturamento atuais.

Guias relacionados

Última modificação em 1 de novembro de 2026