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

# Lien bancaire hébergé : envoyer un lien, sans code dans votre page

> Créez un lien sur votre serveur et envoyez-y la personne. Didit héberge chaque écran et la renvoie vers votre `redirect_url` à la fin.

La Bank Link hébergée de Didit est la façon actuelle de connecter une banque : vous créez un lien, envoyez la personne vers son `url`, et Didit affiche chaque écran sur sa propre page.
Les données bancaires sont disponibles pour les applications sandbox ; les appels d'une application en production renvoient `404` tant que l'accès en production n'a pas été annoncé.

## Créer le lien et l'envoyer à la personne

```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"
  }'
```

Redirigez le navigateur vers l'`url` de la réponse, ou placez-la dans un e-mail ou un message.
L'`url` n'est renvoyée qu'au moment de la création du lien, et elle cesse de fonctionner à l'expiration du lien (60 minutes par défaut, de 5 minutes à 24 heures avec `expires_in`).

## Ce qui se passe à la fin

* Avec un `redirect_url` accepté par Didit, le navigateur revient vers cette adresse. Voir [Retourner sur votre site](https://docs.didit.me/fr/integration/bank-link/return-to-your-site.md).
* Sans cette valeur, le parcours se termine sur la page de résultat de Didit.
* Dans les deux cas, le webhook `bank.link.completed` et `GET /v3/bank/links/{id}/` vous indiquent le résultat.

## Confirmez côté serveur

Lorsque `bank.link.completed` arrive, appelez `GET /v3/bank/links/{id}/` avec l'identifiant du lien que vous avez enregistré pour cet utilisateur.
Il renvoie `status: completed` avec le `connection_id`, ou un échec définitif avec un `error.code`.
Poursuivez ensuite avec le [démarrage rapide](https://docs.didit.me/fr/core-technology/bank-verification/quickstart.md#étape-4--recevoir-les-webhooks-et-confirmer).


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