> ## 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 Link : redirect_url et retour vers votre site

> Renvoyez l'utilisateur sur votre site après Bank Link via redirect_url. En sandbox, localhost fonctionne ; sinon, il finit sur la page Didit.

Le Bank Link de Didit renvoie la personne vers votre site à la fin de son parcours, si votre lien contient un `redirect_url` accepté par Didit. Sans ce paramètre, la personne termine sur la page de résultat de Didit, et vous obtenez le résultat par le webhook `bank.link.completed` ou en consultant le lien.

## Adresses acceptées aujourd'hui

Dans une application sandbox, une adresse `http` simple sur `localhost`, `127.0.0.1` ou `[::1]` (quel que soit le port ou le chemin, sans identifiants ni fragment) fonctionne comme `redirect_url` sans enregistrement préalable.
Toute autre adresse est refusée avec `400 redirect_url_not_registered` lors de la création du lien.
L'enregistrement d'autres adresses de retour n'est pas encore disponible.

## Créer le lien avec une URL de redirection

```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": "one_time",
    "country": "ESP",
    "redirect_url": "http://localhost:3000/bank/return",
    "vendor_data": "client-7731"
  }'
```

Une fois le lien terminé, le navigateur est redirigé automatiquement vers `redirect_url` quelques secondes après le dernier écran, avec `link_id`, `status` et un `state` signé.
Si la personne annule ou refuse, elle reste sur la page de résultat de Didit, qui comporte un bouton la renvoyant vers votre adresse avec `status=failed`.
Utilisez ces paramètres pour afficher une page : ils servent uniquement à l'affichage.
Le webhook et `GET /v3/bank/links/{id}/` font foi.

## Toujours confirmer côté serveur

Quelles que soient les informations transmises par le navigateur, confirmez le résultat avec `GET /v3/bank/links/{id}/` ou avec le webhook `bank.link.completed`, en utilisant l'identifiant du lien que vous avez enregistré pour cet utilisateur.

## Liens connexes

* [Bank Link hébergé](https://docs.didit.me/fr/integration/bank-link/hosted-link.md)
* [Démarrage rapide](https://docs.didit.me/fr/core-technology/bank-verification/quickstart.md)


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