Webhook
Ein Webhook ist ein automatischer Benachrichtigungsmechanismus, der es einem System ermöglicht, Daten in Echtzeit an ein anderes System zu senden, sobald ein bestimmtes Ereignis eintritt. Im Kontext der Dokumentenprüfung informieren Webhooks die Client-Anwendung sofort über das Ergebnis einer Prüfung, ohne dass diese den Server kontinuierlich abfragen muss.
Im Gegensatz zum klassischen Anfrage-Antwort-Modell (Polling), bei dem die Client-Anwendung den Server regelmäßig abfragen muss, ob ein Vorgang abgeschlossen ist, kehrt der Webhook diese Logik um: Der Server sendet die Information aktiv an die Anwendung, sobald sie verfügbar ist. Technisch stellt der Client eine Callback-URL bereit, an die der Server eine HTTP-POST-Anfrage mit den Ereignisdaten im JSON-Format sendet.
In einem KYC-Prüfungsworkflow spielen Webhooks eine entscheidende Rolle bei asynchronen Prozessen. Wenn ein Dokument eine eingehende Analyse erfordert (erweiterte Echtheitsprüfung, manuelle Überprüfung durch einen Analysten, Abfrage externer Datenbanken), steht das Ergebnis nicht sofort fest. Der Webhook benachrichtigt die Anwendung, sobald die Prüfung abgeschlossen ist, sodass das System den Vorgangsstatus aktualisieren und den Endbenutzer unverzüglich informieren kann.
Die Webhooks von CheckFile decken den gesamten Lebenszyklus einer Prüfung ab: Einreichung empfangen, Extraktion abgeschlossen, Echtheitsanalyse beendet, endgültige Entscheidung (akzeptiert/abgelehnt/Überprüfung erforderlich). Jede Benachrichtigung ist kryptographisch signiert, um ihre Authentizität zu gewährleisten und Injektionsangriffe zu verhindern. Das System verwaltet automatisch Wiederholungsversuche bei Zustellungsfehlern mit exponentiellem Backoff.
Praxisbeispiele
- 1.Eine Neobank konfiguriert einen Webhook, um benachrichtigt zu werden, sobald eine Identitätsprüfung abgeschlossen ist: Wird das Dokument validiert, wird das Konto automatisch aktiviert; wird es abgelehnt, erhält der Kunde eine E-Mail mit der Aufforderung, ein neues Dokument einzureichen.
- 2.Ein Versicherer nutzt Webhooks, um automatisch den nächsten Schritt seines Zeichnungsworkflows auszulösen, sobald Identitäts- und Adressdokumente verifiziert sind, ohne menschliches Eingreifen.
- 3.Eine Immobilien-Crowdfunding-Plattform erhält bei jeder Prüfung von Anlegerunterlagen eine Webhook-Benachrichtigung, die eine Echtzeit-Aktualisierung des Compliance-Dashboards der Rechtsabteilung ermöglicht.