Zum Hauptinhalt springen
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 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

Laufender Zugriff funktioniert bei einer Bank nur, wenn diese Bank ihn zulässt. Fragen Sie den Endpoint für Institutionen ab oder lesen Sie die Abdeckungsseite. 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_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/ 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.

Zugriff beenden

Das Beenden des Zugriffs ist nicht dasselbe wie das Löschen. Lesen Sie Daten, Einwilligung und Löschung, 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/ 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.
Zuletzt geändert am 22. November 2026