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

# Gehosteter Bank Link: Link senden, ohne Code auf deiner Seite

> Link auf deinem Server erstellen, Person an die URL senden. Didit hostet alle Schritte und leitet nach Abschluss an `redirect_url` weiter.

Der gehostete Bank Link von Didit ist derzeit der Weg, eine Bank anzubinden: Sie erstellen einen Link, senden die Person an dessen `url`, und Didit zeigt jeden Bildschirm auf einer eigenen Seite.
Bankdaten sind für Sandbox-Anwendungen verfügbar. Die Aufrufe einer Live-Anwendung liefern `404`, bis der Live-Zugriff angekündigt wird.

## Link erstellen und an die Person senden

```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"],
    "end_user": { "reference": "client-7731" },
    "vendor_data": "client-7731"
  }'
```

Leiten Sie den Browser zur `url` in der Antwort weiter, oder fügen Sie sie in eine E-Mail oder Nachricht ein.
Die `url` wird nur beim Erstellen des Links zurückgegeben. Danach funktioniert der Link nicht mehr, sobald er abläuft (standardmäßig nach 60 Minuten, mit `expires_in` zwischen 5 Minuten und 24 Stunden).

## Was am Ende passiert

* Mit einer `redirect_url`, die Didit akzeptiert, kehrt der Browser dorthin zurück. Siehe [Zurück zu Ihrer Website](https://docs.didit.me/de/integration/bank-link/return-to-your-site.md).
* Ohne eine solche URL endet der Ablauf auf der Ergebnisseite von Didit.
* In beiden Fällen teilen Ihnen der Webhook `bank.link.completed` und `GET /v3/bank/links/{id}/` das Ergebnis mit.

## Auf Ihrem Server bestätigen

Wenn `bank.link.completed` eintrifft, rufen Sie `GET /v3/bank/links/{id}/` mit der Link-ID auf, die Sie für diesen Benutzer gespeichert haben.
Die Antwort enthält `status: completed` mit der `connection_id` oder einen endgültigen Fehler mit einem `error.code`.
Fahren Sie anschließend mit der [Schnellstart-Anleitung](https://docs.didit.me/de/core-technology/bank-verification/quickstart.md#schritt-4-webhooks-empfangen-und-bestätigen) fort.


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