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

> Вернуть пользователя на сайт после Bank Link через redirect_url. Без него он попадёт на страницу результата Didit; в песочнице подойдёт localhost.

Didit Bank Link возвращает пользователя на ваш сайт, когда тот завершает процесс, если ваша ссылка содержит `redirect_url`, который Didit принимает. Без него пользователь завершает процесс на собственной странице результатов Didit, а результат вы узнаёте из webhook `bank.link.completed` или при запросе данных ссылки.

## Какие адреса работают сейчас

В приложении в песочнице адрес с протоколом `http` на `localhost`, `127.0.0.1` или `[::1]` (с любым портом и любым путём, без учётных данных и без фрагмента) работает как `redirect_url` без регистрации.
Любой другой адрес отклоняется с ошибкой `400 redirect_url_not_registered` при создании ссылки.
Регистрация других адресов возврата пока недоступна.

## Создание ссылки с 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"
  }'
```

Когда ссылка завершена, браузер сам переходит на `redirect_url` через несколько секунд после последнего экрана, передавая `link_id`, `status` и подписанный `state`.
Если человек отменяет или отклоняет операцию, он остаётся на странице результата Didit, где есть кнопка возврата на ваш адрес с `status=failed`.
Используйте эти параметры для отображения страницы: они предназначены только для отображения.
Источником истины являются webhook и `GET /v3/bank/links/{id}/`.

## Всегда подтверждайте на своём сервере

Независимо от того, что сообщает браузер, подтвердите результат запросом `GET /v3/bank/links/{id}/` или через webhook `bank.link.completed`, используя id ссылки, который вы сохранили для этого пользователя.

## Связанные материалы

* [Размещённая банковская ссылка](https://docs.didit.me/ru/integration/bank-link/hosted-link.md)
* [Быстрый старт](https://docs.didit.me/ru/core-technology/bank-verification/quickstart.md)


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