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

# Guía de integración de Finnish Trust Network (FTN)

> Verifica identidades en Finlandia con Finnish Trust Network y Didit: acceso bancario, configuración del flujo, resultados y respaldo con documento.

Finnish Trust Network (FTN) permite a los usuarios elegibles verificar su identidad con una identificación bancaria finlandesa o un certificado móvil compatible.
Usa la [API de Finnish Trust Network](https://docs.didit.me/es/api-reference/digital-id-wallets/ftn.md) para iniciar la autenticación bancaria desde tu propia aplicación sin un flujo de verificación (workflow).
FTN también funciona dentro del paso **ID Verification** del flujo de Didit, con el identificador de wallet `ftn` y el código de país `FIN`.
Para la integración alojada que se describe a continuación, usa la misma creación de sesiones, los mismos resultados de sesión y los mismos webhooks que en tus otros flujos de Didit.

> [!NOTE]
>
> **Finnish Trust Network está disponible para Finlandia.**
> Habilita `ftn` como wallet aceptada en tu flujo para `FIN`.
> El precio publicado es de **\$0.25 por verificación completada**.
> Consulta [cobertura y precios de wallets](https://docs.didit.me/es/core-technology/id-verification/digital-id-wallets.md#precios) para ver todas las wallets compatibles.

## Recorrido del usuario

1. El usuario elige Finlandia y Finnish Trust Network entre los métodos de identidad que acepta tu flujo.
2. Selecciona un banco participante o un certificado móvil compatible.
3. Se autentica con ese servicio y autoriza la verificación de identidad.
4. Vuelve a la sesión de Didit, que valida el resultado de identidad y continúa el flujo.

La persona necesita una identidad activa en el servicio que selecciona y acceso a su método de autenticación.
Introduce sus credenciales bancarias y códigos de aprobación únicamente en la experiencia de autenticación de ese servicio.
Didit no solicita la contraseña bancaria en su formulario de verificación.

El selector de métodos y las pantallas de retorno de Didit usan la configuración de marca y de dominio personalizado de la sesión.
El banco o servicio de identidad seleccionado controla sus propias pantallas de autenticación.

## Configurar el flujo

Abre el paso **Verificación de ID** de tu flujo en la consola, elige **Países** y abre **Finlandia**.
En **Wallets aceptadas**, habilita Finnish Trust Network cuando esté disponible.
Mantén habilitada la verificación de documentos si los usuarios deben poder usar un documento en su lugar.
Guarda y publica el flujo antes de crear una nueva sesión.

Lo siguiente es un fragmento de configuración de `methods`, no una solicitud de flujo completa:

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

No se puede guardar el flujo si una wallet no está disponible.
Consulta [configuración de funciones del flujo](https://docs.didit.me/es/management-api/workflows/feature-configs.md#ocr-/-verificación-de-identidad) para ver el contrato completo de la API y [configuración de la consola](https://docs.didit.me/es/console/id-verification-methods.md) para configurarlo visualmente.

## Resultado verificado

Una comprobación de FTN completada devuelve un resultado de verificación de wallet con nivel de garantía `cryptographic`.
La identidad verificada incluye el nombre del usuario, su fecha de nacimiento y su identificador personal cuando el método de identidad seleccionado los devuelve.
FTN no devuelve un retrato.
Inspecciona el resultado real en lugar de dar por hecho que todos los campos de identidad opcionales están presentes.

La tarjeta **Credential** de la sesión muestra la wallet seleccionada y su evidencia verificada.
Consulta el [modelo de datos de verificación de identidad](https://docs.didit.me/es/reference/data-models.md#verificación-de-identidad) para ver el esquema del resultado.
Una autenticación FTN correcta completa el paso de Verificación de identidad; las comprobaciones restantes siguen determinando la decisión final de la sesión.
Mantén configurados los pasos independientes de prueba de vida y comparación facial cuando tu flujo los requiera.

## Cancelación y alternativa con documento

Si el usuario cancela, la solicitud expira o la verificación falla, Didit aplica la configuración `wallet.on_failure` del país.
`fallback_to_document` inicia la captura del documento cuando la verificación de documentos está habilitada para Finlandia.
`decline` rechaza el paso de Verificación de identidad.
Un método de documento deshabilitado no puede servir como alternativa.
Para dirigir primero a los usuarios a Finnish Trust Network y mostrar la captura del documento solo después de un fallo, establece `document.fallback_only` en `true`.
Consulta [Ofrecer la captura del documento solo como alternativa](https://docs.didit.me/es/core-technology/id-verification/verification-methods.md#ofrecer-la-captura-de-documento-solo-como-respaldo).

Una redirección o un selector de bancos mostrado no constituyen una verificación de identidad exitosa.
Espera al resultado de la sesión verificada o al webhook antes de conceder acceso.
Gestiona la entrega duplicada de webhooks con el mismo procesamiento idempotente que el resto de tu integración.

## Probar y lanzar

Prueba la wallet en el entorno en el que está habilitada.
Prueba el retorno exitoso, la cancelación por parte del usuario, la expiración, la identidad incompleta y la alternativa con documento.
Prueba también los dispositivos y contextos de navegador de los que dependen tus usuarios.
Un resultado simulado en sandbox no demuestra una autenticación bancaria real ni la activación en producción.

FTN cuesta **\$0.25 por verificación completada** según la tarifa base publicada.
Los intentos de wallet cancelados, expirados y fallidos no generan cargo por verificación de wallet completada.
Una alternativa con documento completada se cobra por separado según los precios de verificación de documentos.
Consulta [precios de wallets](https://docs.didit.me/es/core-technology/id-verification/digital-id-wallets.md#precios) para ver las reglas de facturación vigentes.

## Guías relacionadas

* [Cobertura y precios de wallets de identidad digital](https://docs.didit.me/es/core-technology/id-verification/digital-id-wallets.md)
* [Integración de Smart-ID y Mobile-ID](https://docs.didit.me/es/core-technology/id-verification/smart-id-mobile-id.md)
* [Métodos de verificación de identidad](https://docs.didit.me/es/core-technology/id-verification/verification-methods.md)
* [Integración de webhooks](https://docs.didit.me/es/integration/webhooks.md)


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