> ## 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 重定向 URL（redirect_url）：返回网站

> 在 Didit 的 Bank Link 中使用 redirect_url，完成后将用户送回你的网站。沙盒环境可使用 localhost 地址；未设置时，用户将停留在 Didit 的结果页面。

Didit 的 Bank Link 会在用户完成操作后将其送回您的网站，前提是您的链接中包含 `redirect_url`，且 Didit 接受该地址。
如果没有这一参数，用户将在 Didit 自己的结果页面完成流程，您需要通过 `bank.link.completed` Webhook 或读取链接状态来获知结果。

## 当前可用的地址

在沙盒应用中，使用普通 `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}/` 或 `bank.link.completed` Webhook 进行确认，并使用您为该用户存储的链接 ID。

## 相关内容

* [托管式银行链接](https://docs.didit.me/zh/integration/bank-link/hosted-link.md)
* [快速入门](https://docs.didit.me/zh/core-technology/bank-verification/quickstart.md)


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