> ## 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 Return to Your Site: Redirect URL

> Send the person back to your site after Bank Link with redirect_url. In sandbox a localhost address works; without it they end on Didit's result page.

Didit's Bank Link sends the person back to your site when they finish, if your link carries a `redirect_url` that Didit accepts.
Without one, the person finishes on Didit's own result page and you learn the result from the `bank.link.completed` webhook or from a read of the link.

## Which addresses work today

In a sandbox application a plain `http` address on `localhost`, `127.0.0.1` or `[::1]` (any port, any path, no credentials, no fragment) works as `redirect_url` without registration.
Any other address is refused with `400 redirect_url_not_registered` when you create the link.
Registering other return addresses is not available yet.

## Create the link with a redirect URL

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

When the link completes, the browser goes to `redirect_url` by itself a few seconds after the last screen, with `link_id`, `status` and a signed `state`.
If the person cancels or declines, they stay on Didit's result page, which has a button back to your address with `status=failed`.
Use these parameters to show a page: they are for display only.
The webhook and `GET /v3/bank/links/{id}/` are the authority.

## Always confirm on your server

Whatever the browser tells you, confirm with `GET /v3/bank/links/{id}/` or the `bank.link.completed` webhook, using the link id you stored for that user.

## Related

* [Hosted Bank Link](https://docs.didit.me/integration/bank-link/hosted-link.md)
* [Quickstart](https://docs.didit.me/core-technology/bank-verification/quickstart.md)


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