Ein kontinuierlicher Bankdatenfeed versorgt ein Buchhaltungs- oder Buchführungsprodukt jeden Tag mit den Salden und Transaktionen der Bankkonten jedes Kunden, ohne dass sich der Kunde erneut anmelden muss.
Mit Didit erstellen Sie einen Link mit laufendem Zugriff, empfangen Webhooks, sobald neue Daten vorliegen, lesen mithilfe eines Cursors nur die Änderungen, überwachen, wann die Einwilligung endet, und beenden oder löschen den Zugriff, wenn der Kunde den Dienst verlässt.
Diese Anleitung führt Sie von Grund auf zu einem täglichen Datenfeed für einen Kunden.
Derselbe Code funktioniert für jeden Kunden: eine Verbindung pro Kunde und Bank.
Was Sie benötigen
- Ein API-Schlüssel mit der Berechtigung für Bankdaten für Ihre Sandbox-Anwendung. Siehe Schnellstart.
- Ein Webhook-Ziel, das die
bank.*-Ereignisse empfängt. Siehe Bank-Webhooks.
- Eine Tabelle in Ihrer Datenbank für die Verbindungs-ID, den Cursor des Änderungsfeeds und das Ende der Einwilligung jedes Kunden.
Schritt 1: Verknüpfung mit fortlaufendem Zugriff erstellen
access: ongoing hält den Zugriff offen, bis die Einwilligung endet. consent_days ist eine Anfrage: Das tatsächliche Datum legt die Bank fest und sie wird bei der Verbindung angezeigt.
history_from fordert den Verlauf ab einem Datum an, zum Beispiel ab Jahresbeginn. Alternativ können Sie history_days (1 bis 365) verwenden, wenn Sie das lieber möchten. Verwenden Sie niemals beide Parameter. Die Bank liefert unter Umständen weniger: Jedes Konto meldet seine history_coverage.
ownership.compare: none überspringt den Abgleich des Kontoinhabers, daher wird keine Referenzidentität benötigt. Verwenden Sie business, um den Kontoinhaber mit einem in Didit verifizierten Unternehmen abzugleichen.
end_user.reference ist Ihre ID für den Kunden. Sie ist durchsuchbar und ermöglicht es Didit zu erkennen, wenn derselbe Kunde dieselben Konten erneut verbindet.
- Senden Sie den Kunden zur gehosteten Seite und leiten Sie ihn mit einer Weiterleitungs-URL zurück zu Ihrem Produkt.
Speichern Sie die id der Verknüpfung zusammen mit dem Kunden.
Schritt 2: auf die Verbindung warten
Wenn der Client den Vorgang abschließt, wird bank.link.completed mit der connection_id übermittelt.
Bestätigen Sie sie, da dem Browser niemals vertraut wird:
Speichern Sie die connection_id und warten Sie auf bank.connection.created. Danach sind die Konten, Guthaben und aktuellen Transaktionen lesbar (sync.initial_status ist succeeded oder partial).
bank.connection.history_complete folgt, wenn das Nachladen des Verlaufs abgeschlossen ist.
Für jedes Konto zeigt history_coverage.oldest_booking_date an, wie weit zurück die Bank tatsächlich Daten geliefert hat.
Schritt 3: Erste Kopie laden
Ein leerer Cursor gibt alle aktuellen Transaktionen als added mit reset: true zurück.
Blättern Sie seitenweise durch und speichern Sie den Cursor erst am Ende:
- Der erste Abruf ist eine echte Momentaufnahme: Er gibt jede Transaktion, die zu Beginn des Abrufs in der Verbindung vorhanden war, genau einmal als
added in ihrem aktuellen Zustand zurück, auch wenn während des Durchblätterns eine Synchronisierung läuft.
- Änderungen, die während des Durchblätterns auftreten, kommen beim nächsten Abruf über
next_cursor: Eine Transaktion, die Sie bereits erhalten haben, kommt erneut als modified, eine neue als added.
- Speichern Sie
next_cursor erst nach einer Antwort mit has_more: false.
- Wenn das Durchblättern mittendrin fehlschlägt, starten Sie neu vom zuletzt gespeicherten Cursor.
- Guthaben lesen Sie mit
GET /v3/bank/accounts/{account_id}/balances/.
Schritt 4: bei jedem Webhook auf dem neuesten Stand bleiben
Didit synchronisiert jede aktive laufende Verbindung automatisch ein- bis viermal täglich, je nach Bank (sync.frequency_per_day).
Wenn eine Synchronisierung Änderungen speichert, wird bank.data.updated mit der connection_id, den account_ids und den Anzahlen übermittelt.
Rufen Sie den Änderungsfeed mit Ihrem gespeicherten Cursor auf:
added sind neue Transaktionen, einschließlich ausstehender.
modified sind Transaktionen, die sich geändert haben, in ihrem aktuellen Zustand. Wenden Sie jede als Upsert anhand von id an: Eine Transaktion, die Sie bereits haben, wird aktualisiert, und eine, die Sie noch nicht haben, wird hinzugefügt.
removed enthalten einen reason. Ignorieren Sie eine id, die Sie nicht haben. Wenn eine ausstehende Transaktion gebucht wird, wird sie mit pending_booked in removed geführt, und die gebuchte Transaktion erscheint in added.
Verwenden Sie die Transaktions-id als Schlüssel: Sie bleibt bei Lesevorgängen, Synchronisierungen und Erneuerungen gleich.
Prüfen Sie identity_quality: Bei derived kann eine Korrektur der Bank als je ein removed und ein added erscheinen.
Lesevorgänge werden nie abgerechnet, aber die Daten ändern sich nur, wenn eine Synchronisierung läuft. Daher reicht ein Lesevorgang pro Webhook aus.
Um früher abzurufen, verwenden Sie Sync Now: Bankdaten bei Bedarf aktualisieren.
Schritt 5: Umgang mit einem Reset
Ein Cursor, der älter als das Replay-Fenster ist, liefert 410 cursor_expired mit bootstrap: true.
Das Änderungsprotokoll ist 90 Tage lang wiederholbar, daher tritt dieser Fall bei einem täglichen Job selten auf.
Beginnen Sie erneut mit einem leeren Cursor und ersetzen Sie Ihre Kopie durch das Ergebnis, statt es hinzuzufügen.
Jeder Abruf mit einem leeren Cursor enthält reset: true, sodass derselbe Codepfad sowohl eine neue Verbindung als auch einen abgelaufenen Cursor verarbeitet.
Schritt 6: Ablauf der Einwilligung überwachen
Die Einwilligung hat ein Ablaufdatum: consent.expires_at.
Didit sendet bank.connection.consent_expiring 14, 7 und 1 Tag vor diesem Datum.
Rufen Sie renew_connection auf, wenn Sie erneuern möchten. Die Methode antwortet mit 409 renewal_not_needed, solange noch mehr als 30 Tage verbleiben.
Die Seite, auf der der Kunde eine Erneuerung abschließt, ist noch nicht verfügbar.
Lässt der Kunde die Einwilligung auslaufen, hat die Verbindung den Status renewal_required. Die bereits synchronisierten Daten können Sie weiterhin abrufen.
Details finden Sie unter Eine Bankeinwilligung erneuern.
Schritt 7: Zugriff beenden und löschen
- Der Kunde verlässt Ihr Produkt: Rufen Sie
revoke_connection auf, um das Auslesen sofort zu beenden, oder delete_connection, um das Auslesen zu beenden und die gespeicherten Daten zu löschen.
- Der Kunde beendet die Freigabe bei der Bank:
bank.connection.revoked wird mit ended_by gesendet. Beenden Sie Ihren Datenfeed für diese Verbindung.
Preis
Laufender Zugriff wird pro aktiver Verbindung und Monat berechnet.
Der Preis umfasst alle Konten der Verbindung, Guthaben, Transaktionen, bis zu 365 Tage Historie, sofern die Bank sie liefert, die automatischen Synchronisierungen, Live-Synchronisierungen innerhalb der Grenzen der Bank, Erneuerungen, Webhooks und alle Abfragen.
Ein Link, über den niemand den Vorgang abschließt, ist kostenlos, ebenso Verbindungen mit renewal_required, paused und revoked.
Siehe Preise.
Checkliste
Zuletzt geändert am 22. November 2026