Zum Hauptinhalt springen
Didit sendet Bank-Webhooks, wenn ein Link endet, sich eine Verbindung ändert, die Einwilligung bald abläuft oder eine Synchronisierung neue Daten speichert. Sie verwenden dieselbe Umschlagstruktur, Signierung und Wiederholungsversuche wie alle anderen Didit-Webhooks. Sie enthalten nur IDs und Status: Um die Daten zu lesen, rufen Sie das Objekt ab.
Bank-Webhook-Ereignisse werden für Anwendungen in der Produktionsumgebung und in der Sandbox gesendet. Wählen Sie die Ereignisse pro Webhook-Ziel mit dem Ereignisfilter des Ziels aus, wie bei anderen Ereignissen. Den Umschlag, die Signatur-Header und die Wiederholungsversuche finden Sie unter Webhooks.

Ereignisse

Jedes Ereignis enthält außerdem die gemeinsamen Felder event_id, webhook_type, timestamp, created_at, application_id und environment. Die Ereignisse bank.link.* enthalten ihre Felder unter data. Die Ereignisse zu Verbindung, Daten und Synchronisierung enthalten ihre Felder auf der obersten Ebene. ended_by hat einen der Werte end_user, bank, customer oder unknown. Das genaue Schema jedes Ereignisses finden Sie in der API-Referenz.

Beispiel

Verwendung der Ereignisse

  • Neue Daten. bank.data.updated ist nur ein Signal, es werden keine Daten übermittelt. Rufen Sie den Änderungsfeed mit Ihrem gespeicherten Cursor auf. Verwenden Sie bank.sync.completed nur, wenn Sie jede Synchronisation sehen möchten, auch solche, die nichts geändert haben.
  • Onboarding. Warten Sie auf bank.connection.created, bevor Sie Konten abrufen, und auf bank.connection.history_complete, bevor Sie sich auf den vollständigen Verlauf verlassen.
  • Einwilligung. Bei bank.connection.consent_expiring bitten Sie die Person, die Einwilligung zu erneuern. Bei bank.connection.renewal_required sind die Daten weiterhin lesbar, werden aber nicht mehr synchronisiert.
  • Beenden. Bei bank.connection.revoked beenden Sie Ihren eigenen Feed für diese Verbindung und entscheiden, ob Sie die gespeicherten Daten löschen möchten.
  • Duplikate. Behandeln Sie jedes Ereignis idempotent: Verwenden Sie die Ereignis-ID als Schlüssel und rechnen Sie damit, dass dasselbe Ereignis gelegentlich zweimal eintrifft.
  • Dem Browser nie vertrauen. Bestätigen Sie einen Link mit bank.link.completed oder GET /v3/bank/links/{id}/, nicht mit einer Link-ID, die eine Seite sendet.

Nächste Schritte

Zuletzt geändert am 22. November 2026