Entwicklerleitfaden für dynamische Fallback-Workflows bei IDV-APIs (DE)
Erfahren Sie, wie Sie robuste dynamische Fallback-Workflows für Identity Verification (IDV) APIs implementieren, um die Benutzererfahrung zu verbessern und hohe Verifizierungsraten sicherzustellen.

Proaktive FehlerbehandlungImplementieren Sie robuste Fehlerbehandlungs- und Wiederholungsmechanismen in Ihren IDV-API-Integrationen, um zu verhindern, dass Verifizierungsfehler die Benutzererfahrung beeinträchtigen.
Mehrstufige VerifizierungEntwerfen Sie Workflows, die mehrere Verifizierungsmethoden umfassen, um nahtlose Übergänge zu alternativen Prüfungen zu ermöglichen, falls eine primäre Methode fehlschlägt oder zu unschlüssigen Ergebnissen führt.
Optimierte BenutzererfahrungNutzen Sie dynamische Fallbacks, um Benutzer durch alternative Verifizierungspfade zu leiten, Reibungsverluste zu minimieren und eine erfolgreiche Registrierung oder Transaktionsabwicklung sicherzustellen.
Didits orchestrierte WorkflowsNutzen Sie Didits modulare und KI-native Plattform, um komplexe, dynamische Fallback-Workflows mit einem No-Code Visual Builder oder sauberen APIs zu erstellen und zu verwalten, um maximale Flexibilität und Zuverlässigkeit zu gewährleisten.
Die Bedeutung dynamischer Fallback-Workflows in der IDV
In der Welt der Online-Identitätsprüfung ist die Abhängigkeit von einem einzigen API-Aufruf zur Bestätigung der Identität eines Benutzers ein Rezept für potenzielle Fehler und eine schlechte Benutzererfahrung. Faktoren wie schlechte Bildqualität von Dokumenten, Netzwerklatenz, API-Ratenbegrenzungen oder sogar vorübergehende Dienstausfälle können den Verifizierungsprozess stören. Hier werden dynamische Fallback-Workflows unverzichtbar. Eine gut konzipierte Fallback-Strategie stellt sicher, dass, wenn eine primäre Verifizierungsmethode fehlschlägt, das System intelligent auf eine Alternative umschwenken kann, wodurch die Benutzerreise reibungslos bleibt und hohe Erfolgsraten bei der Verifizierung aufrechterhalten werden. Dies verbessert nicht nur die Kundenzufriedenheit, sondern wirkt sich auch direkt auf die Konversionsraten und die betriebliche Effizienz aus.
Für Entwickler bedeutet der Aufbau resilienter Systeme, Fehler zu antizipieren und einen Plan B, C und sogar D zu haben. Starre, unflexible Verifizierungsabläufe führen oft dazu, dass Benutzer den Prozess abbrechen, wenn sie auf einen Fehler stoßen. Dynamische Fallbacks hingegen bieten Flexibilität und ermöglichen es Unternehmen, sich an Echtzeitbedingungen und Benutzereingaben anzupassen. Dies ist besonders kritisch für Anwendungen, die sensible Prozesse wie die Kundenregistrierung, Altersverifizierung für regulierte Inhalte oder hochwertige Transaktionen umfassen, bei denen eine robuste Identitätssicherung von größter Bedeutung ist.
Effektive Fallback-Logik entwerfen
Die Implementierung dynamischer Fallback-Workflows erfordert eine sorgfältige Planung und ein tiefes Verständnis Ihrer Verifizierungsanforderungen. Die Kernidee besteht darin, eine Abfolge von Verifizierungsschritten und bedingter Logik zu definieren, die den Ablauf basierend auf dem Ergebnis jedes Schritts steuert. So gehen Sie dabei vor:
1. Potenzielle Fehlerquellen identifizieren
Bevor Sie Fallbacks entwerfen, müssen Sie wissen, was schiefgehen kann. Häufige Fehlerquellen in der IDV sind:
- Probleme beim Dokumentenscan: Unscharfe Bilder, Blendung, falscher Dokumententyp oder abgelaufene Dokumente können zu Fehlern bei der ID-Verifizierung (OCR, MRZ, Barcodes) führen.
- Fehler bei der Liveness-Erkennung: Benutzer, die Liveness-Prüfungen aufgrund schlechter Beleuchtung, Deepfakes oder Nichteinhaltung von Anweisungen nicht bestehen.
- Fehlende Übereinstimmungen beim Face Match: Diskrepanzen zwischen dem Dokumentenfoto und dem Live-Selfie.
- Datenübereinstimmungsfehler: Aus einem Dokument extrahierte Informationen stimmen nicht mit Datenbankeinträgen oder vom Benutzer bereitgestellten Daten überein.
- AML-Screening-Flags: Ein Benutzer erscheint auf einer Beobachtungsliste, was eine weitere manuelle Überprüfung erfordert.
- API-Service-Unterbrechungen: Vorübergehende Nichtverfügbarkeit oder Fehler eines Identitätsverifizierungsanbieters.
2. Bedingte Logik und alternative Pfade definieren
Sobald Fehlerquellen identifiziert wurden, erstellen Sie alternative Pfade. Zum Beispiel:
- Wenn eine anfängliche ID-Verifizierung (OCR) aufgrund schlechter Bildqualität fehlschlägt, fordern Sie den Benutzer auf, das Foto erneut aufzunehmen oder zu einem anderen Dokumenttyp zu wechseln.
- Wenn die passive und aktive Liveness-Erkennung ein hohes Betrugsrisiko anzeigt, lösen Sie eine manuelle Überprüfung aus oder fordern Sie zusätzliche Nachweise wie einen Adressnachweis an.
- Wenn ein 1:1 Face Match fehlschlägt, bieten Sie vielleicht eine Alternative wie Telefon- & E-Mail-Verifizierung in Kombination mit spezifischen wissensbasierten Authentifizierungsfragen an.
- Bei Altersverifizierungsszenarien, wenn die Altersschätzung unschlüssig ist, fordern Sie einen Scan eines physischen Ausweises an.
- Wenn eine AML-Screening- & Überprüfungsprüfung eine potenzielle Übereinstimmung liefert, leiten Sie den Benutzer automatisch an einen Compliance-Beauftragten zur weiteren Untersuchung weiter, ohne den Benutzerfluss zu unterbrechen.
Didits orchestrierte Workflows, die über die No-Code Business Console zugänglich sind, sind genau dafür konzipiert und ermöglichen es Ihnen, komplexe Entscheidungsbäume und bedingte Schritte visuell zu konstruieren, ohne eine einzige Codezeile schreiben zu müssen. Dieser modulare Ansatz bedeutet, dass Sie Identitätsprüfungen mischen und anpassen und Schwellenwerte für Erfolg oder Misserfolg einfach definieren können.
3. Benutzererfahrung priorisieren
Fallbacks sollten sich nicht wie eine Bestrafung anfühlen. Das Ziel ist es, den Benutzer engagiert zu halten und Reibungsverluste zu reduzieren. Geben Sie klare, prägnante Anweisungen, wenn ein Fallback ausgelöst wird. Anstatt einer generischen Fehlermeldung sagen Sie dem Benutzer beispielsweise: „Ihr Dokumentenfoto war unscharf. Bitte versuchen Sie es erneut in einem gut beleuchteten Bereich.“ oder „Wir konnten Ihre Identität mit dieser Methode nicht bestätigen. Möchten Sie versuchen, sich mit einem anderen Dokument zu verifizieren oder den Support kontaktieren?“ Die Minimierung der Anzahl der Schritte und die Sicherstellung einer konsistenten UI/UX über alle Verifizierungspfade hinweg ist entscheidend.
Technische Implementierungsstrategien
Aus technischer Sicht umfasst die Implementierung dynamischer Fallback-Workflows mehrere wichtige Überlegungen:
1. API-Orchestrierung und Zustandsverwaltung
Ihr Backend-System muss Aufrufe an verschiedene IDV-APIs orchestrieren und den Zustand des Verifizierungsprozesses verwalten. Dies umfasst die Verfolgung, welche Schritte abgeschlossen wurden, welche fehlgeschlagen sind und welche Fallback-Pfade initiiert wurden. Didits API-First-Ansatz und die Verwendung von „Sessions“ vereinfachen dies. Wenn Sie eine Session mit einer bestimmten Workflow-ID erstellen, übernimmt Didit die gesamte benutzerseitige Erfahrung, die Zustandsverwaltung und die bedingten Schritte. Sie müssen lediglich den Session-Status abfragen, um das Ergebnis zu erfahren.
GET /v3/workflows/
- uuid: a1b2c3d4-5678-90ab-cdef-111111111111
workflow_label: Standard KYC
workflow_type: kyc
features:
- OCR
- LIVENESS
- FACE_MATCH
- uuid: b2c3d4e5-6789-01bc-defg-222222222222
workflow_label: Full Verification + AML
workflow_type: kyc
features:
- OCR
- LIVENESS
- FACE_MATCH
- AML
Dieses API-Beispiel zeigt, wie verschiedene Workflows, jeder mit unterschiedlichen Funktionen wie OCR, Liveness, Face Match und AML, definiert und abgerufen werden können. Sie können dann dynamisch den geeigneten Workflow basierend auf den anfänglichen Verifizierungsergebnissen oder Benutzerdemografien auswählen.
2. Robuster API-Client und Fehlerbehandlung
Ihr API-Client sollte so aufgebaut sein, dass er verschiedene HTTP-Statuscodes und Fehlerantworten elegant verarbeitet. Implementieren Sie Wiederholungsmechanismen mit exponentiellem Backoff für vorübergehende Fehler. Unterscheiden Sie zwischen vorübergehenden Fehlern (z. B. Netzwerkproblemen) und permanenten Fehlern (z. B. ungültige Eingabe), um unnötige Wiederholungen zu vermeiden. Protokollieren Sie alle API-Interaktionen und Fehlerantworten gründlich für Debugging- und Audit-Zwecke.
3. Modulare und zusammensetzbare Identitätsprüfungen
Verwenden Sie eine modulare Architektur, bei der jede Identitätsprüfung (ID-Verifizierung, Liveness, Face Match, AML-Screening, Adressnachweis, Altersschätzung, Telefon- & E-Mail-Verifizierung) eine eigenständige, Plug-and-Play-Komponente ist. Dies ermöglicht es Ihnen, Verifizierungsmethoden einfach auszutauschen oder hinzuzufügen, ohne Ihr gesamtes System neu zu gestalten. Didits Plattform basiert auf diesem Prinzip und bietet zusammensetzbare Identitäts-Primitive über saubere APIs, die die Erstellung benutzerdefinierter Workflows erleichtern.
Wie Didit hilft
Didit wurde von Grund auf entwickelt, um Entwicklern die Werkzeuge an die Hand zu geben, mit denen sie anspruchsvolle und dynamische Identitätsverifizierungs-Workflows erstellen können. Unsere KI-native, entwicklerfreundliche Plattform bietet eine offene, modulare Identitätsschicht, die die Implementierung von Fallbacks und komplexen Verifizierungsabläufen vereinfacht.
- Orchestrierte Workflows: Didits No-Code Visual Builder in der Business Console ermöglicht es Ihnen, mehrstufige Identitätsverifizierungsabläufe zu entwerfen, einschließlich bedingter Logik-Knoten für KYC, Altersprüfungen und AML-Screening. Sie definieren die Logik einmal, und Didit übernimmt die benutzerseitige Erfahrung, die Zustandsverwaltung und die bedingten Schritte. Das bedeutet, Sie können primäre und Fallback-Methoden einfach konfigurieren, wie z.B. beginnend mit der ID-Verifizierung (OCR) und Liveness, und wenn ein Schwellenwert nicht erreicht wird, automatisch eine Adressnachweisanforderung oder eine manuelle Überprüfung auslösen.
- Umfassende Produktsuite: Mit Didit haben Sie Zugriff auf ein vollständiges Spektrum an Verifizierungstools, einschließlich ID-Verifizierung (OCR, MRZ, Barcodes), passiver und aktiver Liveness, 1:1 Face Match & Face Search, AML-Screening & Überwachung, Adressnachweis, Altersschätzung (datenschutzfreundlich), Telefon- & E-Mail-Verifizierung und NFC-Verifizierung (ePass/eID). Dieses umfangreiche Toolkit ermöglicht es Ihnen, praktisch jedes erdenkliche Fallback-Szenario zu erstellen.
- Entwickler-First-Ansatz: Didit bietet eine sofortige Sandbox, öffentliche Dokumentation und saubere APIs, die eine nahtlose Integration ermöglichen. Sie können Workflows programmatisch auflisten, erstellen, aktualisieren und löschen, was Ihnen die volle Kontrolle über Ihre Verifizierungslogik gibt.
- Kostenloses Core KYC: Didit bietet kostenloses Core KYC an, sodass Unternehmen ohne Vorabkosten starten und robuste Workflows aufbauen können. Unser Pay-per-successful-check-Modell und keine Einrichtungsgebühren bedeuten, dass Sie nur zahlen, wenn die Verifizierung erfolgreich ist, wodurch die Kosten an den Wert angepasst werden.
- KI-native Automatisierung: Durch den Einsatz von KI automatisiert Didit einen Großteil des Entscheidungsprozesses innerhalb von Workflows, wodurch der Bedarf an manueller Überprüfung reduziert und die Verifizierungszeiten, selbst bei Fallbacks, beschleunigt werden.
Bereit zum Start?
Möchten Sie Didit in Aktion sehen? Fordern Sie noch heute eine kostenlose Demo an.
Beginnen Sie kostenlos mit der Identitätsprüfung mit Didits kostenlosem Tarif.