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

# 银行数据 API：连接银行并读取交易

> 通过 Didit 的 Bank Link 连接客户银行账户一次，验证账户归属，并用一个 API、一个价格持续读取余额和交易。

Didit 的银行数据 API 可让您的产品通过 Bank Link 连接个人或企业的银行账户、核验账户所有者，并在银行和个人允许的期限内读取账户余额和交易记录。您可以使用一个 API 密钥、一个 Webhook endpoint 和一份价格表，这些与身份验证、企业验证和 AML 筛查所使用的是相同的。

> [!NOTE]
>
> **可用性。** 银行数据目前仅面向沙盒应用开放。
> 在宣布开放生产环境访问之前，生产环境应用的调用将返回 `404`，沙盒环境中不产生任何费用。
> 请从 [快速入门](https://docs.didit.me/zh/core-technology/bank-verification/quickstart.md) 开始。
> [覆盖范围页面](https://docs.didit.me/zh/core-technology/bank-verification/coverage.md) 和 [机构 endpoint](https://docs.didit.me/zh/standalone-apis/bank-institutions-list.md) 说明了每家银行的支持情况。

## 一句话概括

一个**链接**会创建一个**连接**，连接下有**账户**，账户下有**余额**和**交易**。

| 对象 | 含义 | 存续时长 |
| - | - | - |
| 链接 | 为某一位用户运行一次 [Bank Link](https://docs.didit.me/zh/core-technology/bank-verification/bank-link.md)：连接银行，或续期连接。 | 几分钟到几小时，之后过期。 |
| 连接 | 用户授权您的应用读取某一家银行数据的许可。它包含同意信息、同步状态和连接状态。 | 一次性访问：持续到数据收集结束。持续访问：持续到同意失效为止，按照用户同意的频率续期。 |
| 账户 | 连接中的一个账户，其 ID 在连接存在期间保持不变。 | 与连接的存续时长相同。每次续期后 ID 保持不变。 |
| 余额 | 账户在某一基准日期的某种类型金额。 | 每次同步时被替换。 |
| 交易 | 账户的一笔资金变动，带有稳定的 ID。 | 只要连接存在就一直保留。 |

## 获取银行数据的两种方式与另外两项银行检查

| 您希望 | 使用方式 | 一行说明价格 |
| - | - | - |
| 一次性读取余额和交易记录 | 使用 `access: one_time` 的链接 | 每次检查收费，请参见 [定价](https://docs.didit.me/zh/getting-started/bank-verification-pricing.md#银行数据与持续访问) |
| 持续数月读取余额和交易记录 | 使用 `access: ongoing` 的链接 | 每个活跃连接每月收费 |
| 在付款前确认银行账户的归属与某个姓名一致 | [账户核验](https://docs.didit.me/zh/standalone-apis/bank-account-check.md)，无需登录 | 每次获得响应的检查收费 |
| 确认登录的人拥有该账户 | 使用 `ownership.compare` 的链接，或验证会话中的 [银行验证步骤](https://docs.didit.me/zh/core-technology/bank-verification/verification-methods.md) | 每次完成登录收费 |

## 与众不同之处

* **一个平台。** 身份验证、企业验证、AML 筛查和银行数据共用同一个 API 密钥、同一份合同和同一个控制台。
* **一个链接，满足一次性或持续访问。** 同一个托管的 Bank Link 同时支持两种场景。
* **账户持有人比对是可选的。** 您可以将账户持有人与经 Didit 验证的个人或企业进行比对，如果只需要数据，也可以跳过比对。
* **公开的按使用量付费价格。** 请参阅[定价页面](https://docs.didit.me/zh/getting-started/bank-verification-pricing.md)。
* **稳定的 ID 和变更流。** 账户和交易在续期后保持相同的 ID，而持久游标的变更流只向您返回发生变化的内容。
* **覆盖复杂场景的沙盒。** Didit Test Bank 及其测试客户包括企业账户、较长的历史记录、待处理交易以及仅可一次性访问的银行。

## 选择适合您的路径

> [card] [快速入门](https://docs.didit.me/zh/core-technology/bank-verification/quickstart.md)
>
> 使用沙盒密钥，通过可直接复制粘贴的请求，从零开始完成您的第一批交易。

> [card] [面向会计的持续数据流](https://docs.didit.me/zh/use-cases/bank-data-for-accounting.md)
>
> 每日推送每位客户的余额和交易数据。

> [card] [付款前验证账户](https://docs.didit.me/zh/use-cases/verify-a-payout-account.md)
>
> 无需登录即可核验账户持有人。

> [card] [显示 Bank Link](https://docs.didit.me/zh/core-technology/bank-verification/bank-link.md)
>
> 将用户引导至托管链接，并将其返回您的网站。

## 下一步

* [连接](https://docs.didit.me/zh/core-technology/bank-verification/connections.md)：持续访问、同意、续期以及连接的状态。
* [账户、余额与交易](https://docs.didit.me/zh/core-technology/bank-verification/accounts-balances-transactions.md)：数据模型，以及每家银行发送的字段。
* [Webhook](https://docs.didit.me/zh/core-technology/bank-verification/webhooks.md)：`bank.*` 事件及其使用方法。
* [沙盒](https://docs.didit.me/zh/core-technology/bank-verification/sandbox.md)：Didit Test Bank 及其测试客户。
* [数据、同意与删除](https://docs.didit.me/zh/core-technology/bank-verification/data-consent-and-deletion.md)：用户同意什么、如何停止访问，以及删除会清除哪些内容。
* [定价](https://docs.didit.me/zh/getting-started/bank-verification-pricing.md)：以文字形式列出的所有价格。
* [API 参考](https://docs.didit.me/zh/standalone-apis/bank-data.md)：所有 endpoint。


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