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

# 银行链接：托管式银行连接流程

> 银行链接是用户连接银行账户的统一流程：在服务器上创建链接，再将用户引导至 Didit 的托管页面完成连接。

Didit 的 Bank Link 是一条流程，用户可借此将银行账户连接到您的产品，无论您需要一次性读取还是持续访问。
您在服务器上创建一个链接，然后将用户引导至该链接的托管页面。

## 展示链接

引导终端用户访问链接 `url`，或将其放入电子邮件或消息中：Didit 托管每一个页面。
请参阅 [托管银行链接](https://docs.didit.me/zh/integration/bank-link/hosted-link.md)，并使用 [返回您的网站](https://docs.didit.me/zh/integration/bank-link/return-to-your-site.md) 将终端用户带回您的页面。
您的服务器通过 `GET /v3/bank/links/{id}/` 或 `bank.link.completed` Webhook 确认结果。

## 用户看到的内容

1. **同意。** 谁将读取数据（您的名称和徽标）、读取哪些数据（账户、余额、追溯至某一日期的交易）、保留多久、多久刷新一次，以及如何停止。
2. **个人或企业。** 仅当银行对两者加以区分，且您的请求设置为 `any` 时才会出现。
3. **银行。** 选择器列出能够满足该链接所请求内容的银行。若需要持续访问，则只列出能够保持访问持续有效的银行。
4. **在银行登录。** 在银行自己的页面上进行，绝不在 Didit 的页面内进行。
5. **账户。** 所有符合条件的账户均已预先选中，每个账户都可以取消勾选，但至少需保留一个。
6. **成功。** 显示已关联的账户；若为持续访问，还会显示访问有效期截止至何时。

有关用户同意的内容以及访问如何停止，请参阅[数据、同意与删除](https://docs.didit.me/zh/core-technology/bank-verification/data-consent-and-deletion.md)。

## 银行跳转

银行自己的登录页面无法在框架内运行，因此 Bank Link 会将终端用户带到银行，并将其带回。
链接的状态保存在 Didit 的服务器上，因此关闭标签页不会丢失终端用户已经给出的同意。
最后，终端用户会被带到您的 `redirect_url`（若链接已设置该参数）：参见[返回您的网站](https://docs.didit.me/zh/integration/bank-link/return-to-your-site.md)。

## 安全

* API 密钥永远不会传到浏览器或应用中。
* 创建链接时会检查 `redirect_url`：目前在沙盒应用中，只有 `localhost` 地址有效。请参阅 [返回您的网站](https://docs.didit.me/zh/integration/bank-link/return-to-your-site.md)。
* 事件仅包含 ID，不包含姓名、账号或 token。

## 后续步骤

* 运行[快速入门](https://docs.didit.me/zh/core-technology/bank-verification/quickstart.md)。
* 阅读[`create_link` 参考](https://docs.didit.me/zh/standalone-apis/bank-link-create)，了解每一个选项。


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