> ## Documentation Index
> Fetch the complete documentation index at: https://docs.didit.me/llms.txt
> Use this file to discover all available pages before exploring further.

# Bank-Feed für die Buchhaltung: Salden und Transaktionen

> Mit Didit tägliche Salden und Transaktionen jedes Kunden abrufen: laufende Verbindung, Webhooks, Change-Feed mit Cursor, Reset, Einwilligungsende.

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](https://docs.didit.me/de/core-technology/bank-verification/quickstart.md#schritt-1-api-schlüssel-mit-der-berechtigung-für-bank-data-erstellen).
* Ein Webhook-Ziel, das die `bank.*`-Ereignisse empfängt. Siehe [Bank-Webhooks](https://docs.didit.me/de/core-technology/bank-verification/webhooks.md).
* 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

```bash theme={null}
curl -X POST https://verification.didit.me/v3/bank/links/ \
  -H "x-api-key: $DIDIT_API_KEY" -H "content-type: application/json" \
  -d '{
    "access": "ongoing",
    "country": "ESP",
    "segment": "business",
    "data": ["accounts", "balances", "transactions"],
    "history_from": "2026-01-01",
    "consent_days": 180,
    "ownership": { "compare": "none" },
    "end_user": { "reference": "client-7731", "email": "ana@example.com" },
    "redirect_url": "http://localhost:3000/bank/return",
    "vendor_data": "client-7731"
  }'
```

* `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](https://docs.didit.me/de/integration/bank-link/hosted-link.md) und leiten Sie ihn mit einer [Weiterleitungs-URL](https://docs.didit.me/de/integration/bank-link/return-to-your-site.md) 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:

```bash theme={null}
curl https://verification.didit.me/v3/bank/links/$LINK_ID/ -H "x-api-key: $DIDIT_API_KEY"
```

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:

```bash theme={null}
curl "https://verification.didit.me/v3/bank/connections/$CONNECTION_ID/transactions/sync/?limit=500" \
  -H "x-api-key: $DIDIT_API_KEY"
```

```python theme={null}
cursor, page_token = stored_cursor or "", None
while True:
    params = {"limit": 500, "page_token": page_token} if page_token else {"cursor": cursor, "limit": 500}
    page = get(f"/v3/bank/connections/{connection_id}/transactions/sync/", params)
    if page["reset"] and not page_token:
        wipe_local_copy(connection_id)       # replace, never append
    apply(page["added"], page["modified"], page["removed"])
    if not page["has_more"]:
        store_cursor(connection_id, page["next_cursor"])
        break
    page_token = page["next_page_token"]
```

* 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](https://docs.didit.me/de/use-cases/refresh-bank-data-on-demand.md).

## 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`](https://docs.didit.me/de/standalone-apis/bank-connection-renew) 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](https://docs.didit.me/de/use-cases/renew-bank-consent.md).

## Schritt 7: Zugriff beenden und löschen

* Der Kunde verlässt Ihr Produkt: Rufen Sie [`revoke_connection`](https://docs.didit.me/de/standalone-apis/bank-connection-revoke) auf, um das Auslesen sofort zu beenden, oder [`delete_connection`](https://docs.didit.me/de/standalone-apis/bank-connection-delete), 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](https://docs.didit.me/de/getting-started/bank-verification-pricing.md#bankdaten-und-laufender-zugriff).

## Checkliste

* [ ] Eine Verbindung pro Kunde und Bank, gespeichert mit ihrem Cursor und dem Ende der Einwilligung.
* [ ] Webhook-Handler idempotent, mit der Event-ID als Schlüssel.
* [ ] `reset: true` ersetzt Ihre Kopie und fügt nie etwas an.
* [ ] `removed` wird zusammen mit dem zugehörigen Grund verarbeitet.
* [ ] Erinnerungen an die Einwilligung sind mit Ihrer eigenen Benachrichtigung an den Kunden verknüpft.
* [ ] `bank.connection.revoked` beendet den Feed.
* [ ] Der Sandbox-Tarif in [Sandbox](https://docs.didit.me/de/core-technology/bank-verification/sandbox.md#ein-guter-testplan) erfüllt die Anforderungen.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.