> ## 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-Webhooks: Link-, Verbindungs- und Datenereignisse

> Didit-Webhook-Ereignisse bank.link, bank.connection, bank.data und bank.sync: Auslöser, Inhalt und Nutzung für den täglichen Datenabruf.

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.

> [!NOTE]
>
> 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](https://docs.didit.me/de/integration/webhooks.md).

## Ereignisse

| Ereignis | Wann | Felder |
| - | - | - |
| `bank.link.completed` | Eine Person hat eine Bankverbindung hergestellt. | `data.link_id`, `data.status`, `data.connection_id`, `data.check_id`, `data.error_code` (immer `null`) |
| `bank.link.cancelled` | Die Person hat den Vorgang abgebrochen. | `data.link_id`, `data.status` |
| `bank.link.expired` | Der Link ist abgelaufen, bevor der Vorgang abgeschlossen wurde. | `data.link_id`, `data.status` |
| `bank.link.failed` | Der Link endete mit einem Fehler. | `data.link_id`, `data.status`, `data.error_code` |
| `bank.connection.created` | Die erste Synchronisierung ist abgeschlossen und die Konten sind lesbar. | `connection_id`, `initial_status` |
| `bank.connection.history_complete` | Das Nachladen des Verlaufs ist aus einem beliebigen Grund beendet worden. | `connection_id`, `status` |
| `bank.connection.updated` | Der Status, die Einwilligung oder der Synchronisierungsstatus hat sich geändert. | `connection_id`, `status`, `revocation_status` |
| `bank.connection.consent_expiring` | 14, 7 und 1 Tag vor dem Ende der Einwilligung. | `connection_id`, `days_left`, `consent_expires_at`, `renew_by` |
| `bank.connection.renewal_required` | Die Einwilligung ist abgelaufen, oder die Bank fordert die Person auf, sich erneut anzumelden. | `connection_id`, `status`, `reason`, `renew_by`, `renewable_until` |
| `bank.connection.renewed` | Die Erneuerung über einen Erneuerungslink wurde abgeschlossen. | `connection_id`, `status`, `consent_version`, `link_id`, `consent_expires_at` |
| `bank.connection.revoked` | Der Zugriff wurde beendet. | `connection_id`, `status`, `ended_by`, `status_reason`, `ended_at`, `retain_until` |
| `bank.connection.deleted` | Die Verbindung und ihre Daten wurden gelöscht. | `connection_id`, `status`, `erasure_status`, `reason`, `erased_at` |
| `bank.data.updated` | Eine Synchronisierung hat Änderungen gespeichert. | `connection_id`, `sync_id`, `trigger`, `accounts` (IDs mit Anzahlen), `balances_changed` |
| `bank.sync.completed` | Alle Synchronisierungen wurden abgeschlossen. | `connection_id`, `sync_id`, `trigger`, `outcome`, `changed` |
| `bank.sync.failed` | Eine Synchronisierung schlägt wiederholt fehl. | `connection_id`, `sync_id`, `error_code`, `failing_since` |
| `bank.sync.recovered` | Eine fehlgeschlagene Synchronisierung funktioniert wieder. | `connection_id`, `sync_id` |

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](https://docs.didit.me/de/standalone-apis/bank-data.md).

## Beispiel

```json theme={null}
{
  "event_id": "7c1e0a52-93d4-4a6b-8f21-0d5b9e3a64c7",
  "webhook_type": "bank.sync.completed",
  "timestamp": 1763804640,
  "created_at": 1763804640,
  "application_id": "b3e1f0a2-5d64-4c8e-9a17-2f6d0c8b7e41",
  "environment": "sandbox",
  "connection_id": "5e1d2a70-3b4c-4d5e-8f60-71829304a5b6",
  "sync_id": "c2b8d4f6-9a13-4e07-85bc-3d6e1f0a7b92",
  "trigger": "scheduled",
  "outcome": "succeeded",
  "changed": true
}
```

## Verwendung der Ereignisse

* **Neue Daten.** `bank.data.updated` ist nur ein Signal, es werden keine Daten übermittelt. Rufen Sie den [Änderungsfeed](https://docs.didit.me/de/standalone-apis/bank-transactions-sync.md) 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](https://docs.didit.me/de/standalone-apis/bank-connection-delete.md) 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

* [Kontinuierlicher Bankfeed für die Buchhaltung](https://docs.didit.me/de/use-cases/bank-data-for-accounting.md)
* [Sandbox](https://docs.didit.me/de/core-technology/bank-verification/sandbox.md): Die Didit Test Bank löst diese Ereignisse aus.


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