> ## 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 测试银行及其测试客户，端到端测试银行链接与银行数据。链接、连接、Webhook 和读取操作均与生产环境一致。

银行数据可用于沙盒应用。
在宣布开放生产环境访问权限前，生产环境中的应用调用会返回 `404`，沙盒中不产生任何费用。

沙盒应用会获得 Didit Test Bank，其链接、连接、Webhook 和数据读取与生产环境相同。
它永远不会连接真实银行。

## 连接测试银行

1. 使用具有银行数据权限的 API 密钥[创建链接](https://docs.didit.me/zh/standalone-apis/bank-link-create.md)，并打开其 `url`。
2. 接受同意页面，然后选择 **Didit Test Bank**。
3. 在 Test Bank 页面上选择一个测试客户。
4. 选择要共享的账户，然后完成操作。

沙盒链接不会发送电子邮件。

## 测试客户

在 Test Bank 页面中选择一个。

| 测试客户 | 提供的内容 |
| - | - |
| `personal_basic` | 一个活期账户，约 90 天内有 60 笔交易。 |
| `business_multi` | 三个账户（两个企业活期账户和一个储蓄账户），由一家公司持有，分别有 120、45 和 12 笔交易。 |
| `long_history` | 一个账户，包含 400 天、1,400 笔交易的历史记录，可使用 `page_token` 翻页查看。读取时最多只返回其中最近 365 天的记录：创建链接时设置 `history_days: 365` 即可查看（约 1,280 笔交易）。 |
| `pending` | 包含待处理交易的历史记录。 |
| `sparse_fields` | 一家银行不提供起息日、交易对手 IBAN 和银行参考号。 |
| `no_ongoing` | 一家只允许一次性访问的银行。创建链接时使用 `allow_one_time_fallback` 和持续访问：用户确认一次性读取，连接类型为 `one_time`。 |

## 在沙盒中返回您的网站

在沙盒应用中，`localhost`、`127.0.0.1` 或 `[::1]` 上的普通 `http` 地址无需注册即可用作 `redirect_url`。
参见[返回您的网站](https://docs.didit.me/zh/integration/bank-link/return-to-your-site.md)。

## 一份好的测试计划

1. 使用 `business_multi` 连接并开启持续访问，检查三个账户是否都已成功返回。
2. 使用设置了 `history_days: 365` 的链接连接 `long_history`，并通过 `page_token` 翻阅交易记录。
3. 从空游标开始读取变更流，然后使用已保存的 `next_cursor` 再读取一次。
4. 反复调用 [立即同步](https://docs.didit.me/zh/standalone-apis/bank-connection-refresh.md)，直到遇到 `429 refresh_limit_reached`。
5. 使用 [撤销](https://docs.didit.me/zh/standalone-apis/bank-connection-revoke.md) 停止访问，然后删除连接并再读取一次：此时它只返回 `id`、`status`、`status_reason`、`created_at` 和 `erasure`。


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