> ## 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): Integrationsleitfaden

> Finnish Trust Network mit Didit einrichten: Bank-Sign-in, Workflow-Konfiguration, verifizierte Ergebnisse und Dokumenten-Fallback.

Das Finnish Trust Network (FTN) ermöglicht es berechtigten Benutzern, ihre Identität mit einer finnischen Bank-ID oder einem unterstützten Mobilzertifikat zu verifizieren.
Verwenden Sie die [Finnish Trust Network API](https://docs.didit.me/de/api-reference/digital-id-wallets/ftn.md), um die Bank-Authentifizierung direkt aus Ihrer eigenen Anwendung ohne einen Workflow zu starten.
FTN kann auch innerhalb des Didit-Workflow-Schritts **Ausweisverifizierung** ausgeführt werden, unter Verwendung der Wallet-Kennung `ftn` und des Ländercodes `FIN`.
Verwenden Sie für die unten beschriebene gehostete Integration dieselbe Sitzungserstellung, dieselben Sitzungsergebnisse und dieselben Webhooks wie für Ihre anderen Didit-Workflows.

> [!NOTE]
>
> **Finnish Trust Network ist für Finnland verfügbar.**
> Aktivieren Sie `ftn` in den akzeptierten Wallets Ihres Workflows für `FIN`.
> Der veröffentlichte Preis beträgt **\$0.25 pro abgeschlossene Verifizierung**.
> Informationen zu allen unterstützten Wallets finden Sie unter [Wallet-Abdeckung und Preise](https://docs.didit.me/de/core-technology/id-verification/digital-id-wallets.md#preise).

## Benutzerreise

1. Der Benutzer wählt Finnland und Finnish Trust Network aus den Identitätsmethoden aus, die Ihr Workflow akzeptiert.
2. Er wählt eine teilnehmende Bank oder ein unterstütztes Mobilzertifikat aus.
3. Er authentifiziert sich bei diesem Dienst und autorisiert die Identitätsverifizierung.
4. Er kehrt zur Didit-Sitzung zurück, die das Identitätsergebnis validiert und den Workflow fortsetzt.

Die Person benötigt eine aktive Identität bei dem ausgewählten Dienst und Zugriff auf dessen Authentifizierungsmethode.
Sie gibt Bank-Zugangsdaten und Freigabecodes ausschließlich in der Authentifizierungsumgebung dieses Dienstes ein.
Didit fragt im Verifizierungsformular nicht nach einem Bankpasswort.

Die Methodenauswahl und die Seiten für die Rückkehr von Didit nutzen das Branding und die benutzerdefinierten Domain-Einstellungen der Sitzung.
Die ausgewählte Bank oder der jeweilige Identitätsdienst steuert die eigenen Authentifizierungsbildschirme.

## Workflow konfigurieren

Öffnen Sie den Schritt **Ausweisverifizierung** Ihres Workflows in der Konsole, wählen Sie **Länder** und öffnen Sie **Finnland**.
Aktivieren Sie unter **Akzeptierte Wallets** das Finnish Trust Network, sofern verfügbar.
Lassen Sie die Dokumentenverifizierung aktiviert, falls Benutzer stattdessen ein Dokument verwenden können sollen.
Speichern und veröffentlichen Sie den Workflow, bevor Sie eine neue Sitzung erstellen.

Das Folgende ist ein Konfigurationsfragment für `methods`, keine vollständige Workflow-Anfrage:

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

Eine nicht verfügbare Wallet führt dazu, dass das Speichern des Workflows abgelehnt wird.
Den vollständigen API-Vertrag finden Sie unter [Workflow-Funktionskonfigurationen](https://docs.didit.me/de/management-api/workflows/feature-configs.md#ocr-/-ausweisverifizierung) und das visuelle Setup unter [Konfiguration der Konsole](https://docs.didit.me/de/console/id-verification-methods.md).

## Verifiziertes Ergebnis

Eine abgeschlossene FTN-Prüfung gibt ein Wallet-Verifizierungsergebnis mit der Vertrauensstufe `cryptographic` zurück.
Die verifizierte Identität enthält den Namen, das Geburtsdatum und die persönliche Kennung des Benutzers, sofern diese von der gewählten Identitätsmethode übermittelt werden.
FTN gibt kein Porträtfoto zurück.
Prüfen Sie das tatsächliche Ergebnis, anstatt davon auszugehen, dass jedes optionale Identitätsfeld vorhanden ist.

Die Karte **Nachweis** der Sitzung zeigt die ausgewählte Wallet und deren verifizierte Nachweise an.
Das Ergebnisschema finden Sie im [Datenmodell der Ausweisverifizierung](https://docs.didit.me/de/reference/data-models.md#ausweisverifizierung).
Eine erfolgreiche FTN-Authentifizierung schließt den Schritt Ausweisverifizierung ab; verbleibende Prüfungen bestimmen weiterhin die endgültige Entscheidung der Sitzung.
Behalten Sie separate Schritte für Liveness-Erkennung und Gesichtsabgleich konfiguriert, falls Ihr Workflow diese erfordert.

## Abbruch und Dokumenten-Fallback

Wenn der Benutzer abbricht, die Anfrage abläuft oder die Verifizierung fehlschlägt, wendet Didit die Einstellung `wallet.on_failure` des jeweiligen Landes an.
`fallback_to_document` startet die Dokumentenerfassung, wenn die Dokumentenverifizierung für Finnland aktiviert ist.
`decline` lehnt den Schritt Ausweisverifizierung ab.
Eine deaktivierte Dokumentenmethode kann nicht als Fallback dienen.
Um Benutzer zuerst an das Finnish Trust Network weiterzuleiten und die Dokumentenerfassung erst nach einem Fehlschlag anzuzeigen, setzen Sie `document.fallback_only` auf `true`.
Siehe [Dokumentenerfassung nur als Fallback anbieten](https://docs.didit.me/de/core-technology/id-verification/verification-methods.md#dokumentenerfassung-nur-als-fallback-anbieten).

Eine Weiterleitung oder eine angezeigte Bankenauswahl stellt keine erfolgreiche Identitätsverifizierung dar.
Warten Sie auf das verifizierte Sitzungsergebnis oder den Webhook, bevor Sie Zugriff gewähren.
Behandeln Sie doppelte Webhook-Zustellungen mit derselben idempotenten Verarbeitung wie den Rest Ihrer Integration.

## Testen und Inbetriebnahme

Testen Sie die Wallet in der Umgebung, in der sie aktiviert ist.
Testen Sie die erfolgreiche Rückkehr, den Abbruch durch den Benutzer, den Ablauf, eine unvollständige Identität und den Dokumenten-Fallback.
Testen Sie auch die Geräte und Browser-Kontexte, auf die Ihre Benutzer angewiesen sind.
Ein simuliertes Sandbox-Ergebnis ist kein Nachweis für eine echte Bank-Authentifizierung oder die Aktivierung in der Produktionsumgebung.

FTN kostet **\$0.25 pro abgeschlossene Verifizierung** zum veröffentlichten Basistarif.
Abgebrochene, abgelaufene und fehlgeschlagene Wallet-Versuche verursachen keine Gebühren für eine abgeschlossene Wallet-Verifizierung.
Ein abgeschlossener Dokumenten-Fallback wird separat nach den Preisen für die Dokumentenverifizierung abgerechnet.
Aktuelle Abrechnungsregeln finden Sie unter [Wallet-Preise](https://docs.didit.me/de/core-technology/id-verification/digital-id-wallets.md#preise).

## Verwandte Anleitungen

* [Abdeckung und Preise von digitalen ID-Wallets](https://docs.didit.me/de/core-technology/id-verification/digital-id-wallets.md)
* [Integration von Smart-ID und Mobile-ID](https://docs.didit.me/de/core-technology/id-verification/smart-id-mobile-id.md)
* [Methoden der Ausweisverifizierung](https://docs.didit.me/de/core-technology/id-verification/verification-methods.md)
* [Webhook-Integration](https://docs.didit.me/de/integration/webhooks.md)


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