Zum Hauptinhalt springen
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, 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.
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.

​
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:
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 und das visuelle Setup unter Konfiguration der Konsole.

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

​
Verwandte Anleitungen

Zuletzt geändert am 7. November 2026