> ## 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.

# Bankverbindungen: Dauerhafter Zugriff, Einwilligung und Erneuerung

> Eine Verbindung ist die Erlaubnis einer Person, eine Bank auszulesen. Didit zeigt Status, Einwilligungsende, Erneuerung und Widerruf des Zugriffs.

Eine Didit-Bankverbindung ist die Berechtigung einer Person oder eines Unternehmens, mit der Ihre Anwendung eine Bank auslesen darf. Sie umfasst die Einwilligungszeitpunkte, den Synchronisierungsstatus und die Konten dieser Bank.
Ein abgeschlossener [Bank Link](https://docs.didit.me/de/core-technology/bank-verification/bank-link.md) erstellt sie. Sie besteht so lange, wie die Bank und die Person es zulassen.

Bankdaten sind für Sandbox-Anwendungen verfügbar. Die Aufrufe einer Live-Anwendung geben `404` zurück, bis der Live-Zugriff angekündigt wird.

## Einmaliger und laufender Zugriff

| | Einmalig | Laufend |
| - | - | - |
| `access` | `one_time` (Standard) | `ongoing` |
| Was passiert | Die Daten werden einmal gelesen, wenn sich die Person verbindet, danach endet der Zugriff (`status_reason: collection_complete`). | Der Zugriff bleibt offen, bis die Einwilligung endet oder jemand ihn beendet. |
| Daten danach | Über dieselben Endpoints lesbar. | Wird je nach Bank ein- bis viermal täglich automatisch synchronisiert, zusätzlich Live-Synchronisierungen auf Abruf. |
| Abrechnung | Pro Prüfung, siehe [Preise](https://docs.didit.me/de/getting-started/bank-verification-pricing.md) | Pro aktive Verbindung und Monat, siehe [Preise](https://docs.didit.me/de/getting-started/bank-verification-pricing.md) |

Laufender Zugriff funktioniert bei einer Bank nur, wenn diese Bank ihn zulässt.
Fragen Sie den [Endpoint für Institutionen](https://docs.didit.me/de/standalone-apis/bank-institutions-list.md) ab oder lesen Sie die [Abdeckungsseite](https://docs.didit.me/de/core-technology/bank-verification/coverage.md).
Kann eine Bank den Zugriff nicht offen halten, wird der Person mitgeteilt, dass die Bank keinen laufenden Zugriff erlaubt, und sie muss eine andere Bank wählen.
Setzen Sie `allow_one_time_fallback: true`, damit die Person nach der Bestätigung des eingeschränkten Zugriffs auf ihrem eigenen Bildschirm mit einem einmaligen Auslesen fortfahren kann. Die Verbindung ist dann `one_time`.

## Status

| `status` | Bedeutung | Daten lesbar | Synchronisierungen | Abgerechnet |
| - | - | - | - | - |
| `pending` | Die Verknüpfung wurde abgeschlossen und die erste Synchronisierung läuft. | Noch nicht | Läuft | Nein |
| `active` | Die Einwilligung ist gültig, und die Synchronisierung läuft fehlerfrei oder wird erneut versucht. | Ja | Ja | Ja |
| `renewal_required` | Die Einwilligung wurde beendet, oder die Bank bittet die Person, sich erneut anzumelden. `status_reason` gibt an, welcher Fall vorliegt. | Wie zuletzt synchronisiert | Nein | Nein |
| `paused` | Das Guthaben reicht für den Monat nicht aus. | Wie zuletzt synchronisiert | Nein | Nein |
| `revoked` | Der Zugriff wurde von der Person, der Bank oder von Ihnen beendet. `consent.ended_by` gibt an, wer den Zugriff beendet hat. | Bis `consent.retain_until` | Nein | Nein |
| `deleted` | Die Verbindung und ihre Daten wurden gelöscht. | Nein | Nein | Nein |
| `failed` | Die erste Synchronisierung war nie erfolgreich. | Nein | Nein | Nein |

`status_reason` ist einer der folgenden Werte: `collection_complete`, `consent_expired`, `consent_lapsed`, `bank_requires_sign_in`, `revoked_by_end_user`, `revoked_by_bank`, `revoked_by_customer`, `insufficient_balance`, `paused_by_customer` (reserviert, derzeit setzt ihn kein Endpoint) und `first_sync_failed`.

## Einwilligung

Die Bank legt das Ende der Einwilligung fest, höchstens jedoch für den mit `consent_days` angeforderten Zeitraum.
Jede Verbindung zeigt ihre tatsächlichen Daten unter `consent` an:

* `expires_at` und `renew_by`: das Ende der Einwilligung. Erneuern Sie die Verbindung davor, damit keine Lücke entsteht.
* `renewable_until`: der letzte Zeitpunkt, zu dem dieselbe Verbindung nach dem Ende der Einwilligung noch reaktiviert werden kann.
* `renewed_count`, `version`, `scopes_granted` und `accounts_granted`: was gewährt wurde und wie oft die Einwilligung erneuert wurde.

Die Einwilligung gilt so lange, wie die Bank es zulässt.
Lesen Sie den tatsächlichen Wert für jede Verbindung sowie den bankspezifischen Wert für das Institut ab.

## Erneuerung

Eine Erneuerung behält die Verbindungs-ID und jede Konto-ID bei, und der Verlauf wird ohne Duplikate fortgeführt.

1. Didit sendet `bank.connection.consent_expiring` 14, 7 und 1 Tag vor Ablauf.
2. Rufen Sie [`POST /v3/bank/connections/{id}/renew/`](https://docs.didit.me/de/standalone-apis/bank-connection-renew) auf. Solange mehr als 30 Tage übrig sind, antwortet der Endpoint mit `409 renewal_not_needed`. Nach `consent.renewable_until` antwortet er mit `409 renewal_window_expired`. Andernfalls antwortet er mit `201` und einem Erneuerungslink.

Die Seite, auf der die Person eine Erneuerung abschließt, ist noch nicht verfügbar. Leiten Sie Personen daher heute nicht zu einem Erneuerungslink weiter.

Lässt die Person die Einwilligung auslaufen, wechselt die Verbindung in den Status `renewal_required`: Die Daten bleiben im zuletzt synchronisierten Stand lesbar, und es fallen keine Kosten an. Nach `consent.renewable_until` hat die Verbindung den Status `revoked` mit `status_reason: consent_lapsed`, und die Person verbindet sich erneut.

Den vollständigen Ablauf finden Sie unter [Eine Bankeinwilligung erneuern](https://docs.didit.me/de/use-cases/renew-bank-consent.md).

## Zugriff beenden

| Wer | Wie | Was passiert |
| - | - | - |
| Die Person | **Stop sharing** bei ihrer Bank | `bank.connection.revoked` mit `ended_by: end_user` oder `bank` |
| Sie | [`revoke_connection`](https://docs.didit.me/de/standalone-apis/bank-connection-revoke) | Die Bank holt den Stopp sofort ab. Die Einwilligung zeigt `revocation_pending`, danach `revoked`, sobald die Bank bestätigt. Die bereits gelesenen Daten bleiben lesbar, bis Sie die Verbindung löschen oder `consent.retain_until` abgelaufen ist. |
| Sie | [`delete_connection`](https://docs.didit.me/de/standalone-apis/bank-connection-delete) | Beendet den Zugriff und löscht die Verbindung sowie deren Konten, Guthaben und Transaktionen. Nicht rückgängig zu machen. |

Das Beenden des Zugriffs ist nicht dasselbe wie das Löschen.
Lesen Sie [Daten, Einwilligung und Löschung](https://docs.didit.me/de/core-technology/bank-verification/data-consent-and-deletion.md), um genau zu erfahren, was beim Löschen entfernt wird.

## Eine gelöschte Verbindung

Eine gelöschte Verbindung liefert nur `id`, `status` (`deleted`), `status_reason`, `created_at` und `erasure`.
`status_reason` ist `deleted_by_customer`, `consent_lapsed`, `retention_elapsed` oder `application_deleted`.
Alle anderen Felder fehlen.

## Duplikate

Ein neuer Link, der zu genau den Konten führt, die Sie bereits mit demselben `end_user.reference` bei derselben Bank teilen, wird als Erneuerung dieser Verbindung abgeschlossen (`reused: true`), und es wird nichts doppelt berechnet.

Jede andere Überschneidung setzt den Link auf `failed` mit `duplicate_conflict` und `conflicts_with`, bevor etwas gespeichert oder berechnet wird.

Erneuern Sie die bestehende Verbindung oder erstellen Sie den Link erneut mit `"duplicates": "allow"` für eine unabhängige zweite Verbindung.

## Verbindungen Ihrer Kunden verwalten

* Liste mit Filtern: [`GET /v3/bank/connections/`](https://docs.didit.me/de/standalone-apis/bank-connections-list) akzeptiert `status`, `access`, `institution_id`, `country`, `vendor_data`, `end_user_reference`, `consent_expires_before` und `created_after`.
* Anhand des Objekts `billing` sehen Sie, was eine Verbindung kostet: die Einheit, den Preis und den bereits abgerechneten Monat.


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