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

# Bankdaten-Schnellstart: Test-Bank verbinden und Transaktionen lesen

> Von der Sandbox-Anwendung zu Konten, Salden und Transaktionen der Didit Test Bank: API-Schlüssel und Link anlegen, verbinden, lesen und synchronisieren.

Bankdaten sind für Sandbox-Anwendungen verfügbar.
Aufrufe einer Live-Anwendung liefern `404`, bis der Live-Zugang angekündigt wird, und in der Sandbox fallen keine Kosten an.
Diese Schnellstartanleitung führt Sie mit kopierbaren Anfragen von einer Sandbox-Anwendung zu den Konten, Guthaben und Transaktionen der Didit Test Bank.

> [!NOTE]
>
> Jede Antwort unten ist auf die wichtigen Felder gekürzt.
> Bewahren Sie den API-Schlüssel auf Ihrem Server auf: Er gelangt nie in einen Browser oder in eine App.

## Schritt 1: API-Schlüssel mit der Berechtigung für Bank data erstellen

Bank data ist nicht im Vollzugriff enthalten.
Ein Schlüssel mit Vollzugriff, einschließlich des primären Geheimnisses der Anwendung, wird bei jedem Aufruf für Bank data mit `403 bank_data_access_denied` abgelehnt.

1. Öffnen Sie in der [Business Console](https://business.didit.me) Ihre Sandbox-Anwendung und gehen Sie zu **API keys**.
2. Erstellen Sie einen Schlüssel mit benutzerdefiniertem Zugriff und fügen Sie **Bank data** hinzu: **Read** für die Lesezugriffe, **Write** für die Aufrufe, die etwas erstellen, ändern oder löschen.
3. Kopieren Sie den Schlüssel und exportieren Sie ihn:

```bash theme={null}
export DIDIT_API_KEY="your-sandbox-key"
```

Die vollständige Liste der Ressourcen finden Sie unter [API-Schlüssel](https://docs.didit.me/de/console/api-keys.md).

## Schritt 2: Link erstellen

Ein Link ist ein Durchlauf der Bildschirme, über die eine Person eine Bank verbindet.
Erstellen Sie einen dauerhaften Link für die Test-Bank:

```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",
    "data": ["accounts", "balances", "transactions"],
    "history_days": 90,
    "vendor_data": "client-7731"
  }'
```

`country` ist der dreistellige Ländercode der Bank der Person und ist optional.
Senden Sie ihn, wenn Sie ihn kennen, damit die Person nur die Banken dieses Landes sieht. Ohne ihn wählt die Person aus allen Ländern, die Sie bedienen können.
Für einmaligen Zugriff senden Sie `"access": "one_time"` (Standardwert).

```json theme={null}
{
  "id": "0b9c4f1e-6a2d-4e8b-9f31-7c5d2e1a8b40",
  "mode": "connect",
  "access": "ongoing",
  "status": "created",
  "url": "https://verify.didit.me/bank/link/...",
  "expires_at": "2026-11-22T13:00:00Z",
  "connection_id": null
}
```

Speichern Sie die Link-`id` bei Ihrem Benutzer.
`url` und `client_token` werden nur einmal zurückgegeben, und zwar bei der Erstellung des Links.

## Schritt 3: Link öffnen und Didit Test Bank verbinden

Öffnen Sie die `url` in einem Browser oder senden Sie sie per E-Mail oder Chat an die Person.
Die Person sieht den Einwilligungsbildschirm, wählt **Didit Test Bank** aus, meldet sich mit einem der Testkunden an und wählt die Konten aus, die sie freigeben möchte.
Auf der [Sandbox-Seite](https://docs.didit.me/de/core-technology/bank-verification/sandbox.md) finden Sie die Testkunden und welche Daten jeder von ihnen liefert.

Wie Sie die Person anschließend wieder auf Ihre Website zurückleiten, erfahren Sie unter [Zurück zu Ihrer Website](https://docs.didit.me/de/integration/bank-link/return-to-your-site.md).
Ohne `redirect_url` landet die Person auf der Ergebnisseite von Didit, und Sie erfahren das Ergebnis über den Webhook oder über einen Abruf.

## Schritt 4: Webhooks empfangen und bestätigen

Abonnieren Sie in der Konsole ein Webhook-Ziel für die Ereignisse `bank.*`, wie bei jedem [Webhook](https://docs.didit.me/de/integration/webhooks.md).
Sobald die Person den Vorgang abgeschlossen hat, wird `bank.link.completed` mit der `link_id` und der `connection_id` gesendet. Danach folgt `bank.connection.created`, sobald die erste Synchronisierung die Konten gespeichert hat.

Vertrauen Sie niemals einer Link-ID, die Ihnen ein Browser übermittelt.
Rufen Sie den Link selbst ab:

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

```json theme={null}
{ "id": "0b9c4f1e-6a2d-4e8b-9f31-7c5d2e1a8b40", "status": "completed", "connection_id": "5e1d2a70-3b4c-4d5e-8f60-71829304a5b6" }
```

Der `status` ist `completed` oder ein endgültiger Status (`cancelled`, `expired`, `failed`). Ein `failed`-Link enthält einen `error.code`; bei einem `cancelled`-Link steht `error: null`.

## Schritt 5: Konten, Salden und Transaktionen abrufen

```bash theme={null}
curl https://verification.didit.me/v3/bank/connections/$CONNECTION_ID/accounts/ -H "x-api-key: $DIDIT_API_KEY"
curl https://verification.didit.me/v3/bank/accounts/$ACCOUNT_ID/balances/ -H "x-api-key: $DIDIT_API_KEY"
curl "https://verification.didit.me/v3/bank/accounts/$ACCOUNT_ID/transactions/?date_from=2026-01-01" -H "x-api-key: $DIDIT_API_KEY"
```

Beträge sind Dezimalzahlen als Zeichenketten, bei Geldabflüssen mit negativem Vorzeichen.
Eine Seite mit Transaktionen enthält `next_page_token`, solange noch weitere Daten abgerufen werden können.
Siehe [Konten, Salden und Transaktionen](https://docs.didit.me/de/core-technology/bank-verification/accounts-balances-transactions.md).

## Schritt 6: dem Änderungsfeed folgen

Der Änderungsfeed liefert nur die Änderungen seit Ihrem letzten Abruf.
Ihr erster Abruf ohne Cursor ist der vollständige Snapshot: jede Transaktion der Verbindung, jeweils als `added` mit `reset: true`.
Eine erste Seite kann `has_more: true` mit einem `next_page_token` enthalten, aber noch keinen `next_cursor`.
Solange `has_more` den Wert `true` hat, rufen Sie weitere Seiten mit `page_token` ab. Den `next_cursor` der letzten Seite (der mit `has_more: false`) speichern Sie für den nächsten Abruf:

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

`reset: true` bedeutet, dass die Antwort ein vollständiger Snapshot ist: Ersetzen Sie Ihre Kopie durch diese Antwort, statt sie zu ergänzen.
`bank.data.updated` zeigt Ihnen an, wann eine Synchronisierung etwas Neues gespeichert hat.

## Schritt 7: jetzt synchronisieren

Eine laufende Verbindung synchronisiert sich automatisch.
Um die Bank jetzt abzufragen, fordern Sie eine Synchronisation an:

```bash theme={null}
curl -X POST https://verification.didit.me/v3/bank/connections/$CONNECTION_ID/refresh/ -H "x-api-key: $DIDIT_API_KEY"
```

Eine Bank erlaubt pro Tag eine begrenzte Anzahl an Datenabrufen ohne manuelle Auslösung.
`sync.live_syncs_left_today` und `sync.budgets` an der Verbindung zeigen, wie viele noch übrig sind und wann sie zurückgesetzt werden. Ein Aufruf über dem Limit antwortet mit `429 refresh_limit_reached` und dem Zeitpunkt des Zurücksetzens.
Siehe [Bankdaten bei Bedarf aktualisieren](https://docs.didit.me/de/use-cases/refresh-bank-data-on-demand.md).

## Schritt 8: Zugriff beenden und löschen

Das Beenden des Zugriffs und das Löschen sind zwei verschiedene Aufrufe.

```bash theme={null}
# Stop access at the bank. The connection keeps its data until you delete it.
curl -X POST https://verification.didit.me/v3/bank/connections/$CONNECTION_ID/revoke/ -H "x-api-key: $DIDIT_API_KEY"

# Delete the connection and its data. Irreversible.
curl -X DELETE https://verification.didit.me/v3/bank/connections/$CONNECTION_ID/ -H "x-api-key: $DIDIT_API_KEY"
```

Eine gelöschte Verbindung liefert nur `id`, `status`, `status_reason`, `created_at` und `erasure` zurück.
Siehe [Daten, Einwilligung und Löschung](https://docs.didit.me/de/core-technology/bank-verification/data-consent-and-deletion.md).

## Nächste Schritte

* [Verbindungen](https://docs.didit.me/de/core-technology/bank-verification/connections.md): einmaliger und laufender Zugriff, Einwilligung und Erneuerung.
* [Bank-Webhooks](https://docs.didit.me/de/core-technology/bank-verification/webhooks.md)
* [Preise](https://docs.didit.me/de/getting-started/bank-verification-pricing.md)
* [API-Referenz](https://docs.didit.me/de/standalone-apis/bank-data.md)


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