> ## 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 银行数据支持的国家和银行：33 个国家/地区支持登录，47 个国家/地区支持账户核验，并提供各银行的持续访问、同意期限和历史记录数值。

Didit 的银行覆盖范围分为两个层面：各验证方式可用的国家/地区，以及每家银行的能力。两者都来自 API，因此本页描述的是结构，而当前的实际情况以 endpoint 返回的内容为准。

## 国家/地区

* **银行登录：** 33 个国家/地区。
* **账户核验：** 47 个国家/地区。无论您调用[账户核验 API](https://docs.didit.me/zh/standalone-apis/bank-account-check.md)，还是在验证流程中使用，覆盖的国家/地区和价格都相同。企业账户持有人在除中国以外的所有地区均可获得服务。
* **两种方式：** 23 个国家/地区。至少支持一种方式：57 个国家/地区。
* **持续访问：** 取决于银行。覆盖范围和机构 endpoint 会显示哪些银行提供该服务。
* **沙盒：** Didit Test Bank。参见[沙盒](https://docs.didit.me/zh/core-technology/bank-verification/sandbox.md)。

各国家/地区的价格请参见[定价页面](https://docs.didit.me/zh/getting-started/bank-verification-pricing.md)。

## 通过 API 读取覆盖范围

[`GET /v3/bank/coverage/`](https://docs.didit.me/zh/standalone-apis/bank-coverage) 会为每个国家/地区返回一行数据：

| 字段 | 含义 |
| - | - |
| `sign_in_available`, `account_check_available` | 该国家/地区提供哪些方式。 |
| `ongoing_access` | 该国家/地区至少有一家银行提供持续访问。 |
| `institutions`, `ongoing_institutions` | 已列出的银行，以及其中提供持续访问的银行数量。 |
| `consent_days_max` | 该国家/地区任一银行允许的最长同意期限。 |
| `history_days_max` | 该国家/地区任一银行可提供的最长历史数据期限。 |
| `business_accounts` | 至少有一家银行支持企业账户。 |

## 查看银行支持的能力

[`GET /v3/bank/institutions/`](https://docs.didit.me/zh/standalone-apis/bank-institutions-list) 支持按 `country`、`segment`、`access` 和 `q` 筛选，[`GET /v3/bank/institutions/{id}/`](https://docs.didit.me/zh/standalone-apis/bank-institution-get) 返回单个银行的信息。

| 能力 | 含义 |
| - | - |
| `segments` | `personal`、`business` 或两者兼有。 |
| `access` 和 `ongoing_access` | 该银行是否允许 `one_time` 和 `ongoing` 访问。 |
| `consent_days_max` | 该银行允许的最长同意期限。 |
| `history_days_max` | 该银行提供的最长历史数据期限。 |
| `pending_transactions`、`pending_linkage` | 该银行是否报告待处理交易，以及是否将其与已入账交易关联。 |
| `balance_types`、`transaction_fields` | 已知该银行会发送的余额类型和交易字段。 |
| `corporate_accounts` | 是否支持企业账户。 |
| `sign_in` | 用户的登录方式：`redirect`、`app_approval` 或 `credentials`。 |
| `reconfirmation` | 续期能否在 Didit 的页面上完成确认，而无需再次登录银行。 |
| `sync_frequency_hours` | 在该银行允许更高同步频率的情况下，自动同步之间的小时数。`null` 表示该银行的默认值，即每天同步一到四次。 |
| `timezone` | 该银行日期所使用的 IANA 时区。 |
| `health` | `operational`、`degraded` 或 `down`。 |

Didit 从未观察到的值为 `null`，而不是猜测值。值每天刷新。

> [!NOTE]
>
> 持续访问按银行和细分类型分别提供。
> `ongoing_access` 字段是所有计数的唯一依据，因此请以它为准进行核实，而不要假定覆盖国家内的银行都支持持续访问。

## 银行不在覆盖范围内时

* 当 `access: ongoing` 且预先选定的银行无法保持访问权限时，链接会返回 `400 ongoing_access_not_available`。
* 设置 `allow_one_time_fallback: true`，即可让用户以一次性读取的方式继续。
* 仅需核验账户所有权时，可使用无需登录的[账户核验](https://docs.didit.me/zh/core-technology/bank-verification/account-check.md)。
* 查看其他[备选方案](https://docs.didit.me/zh/core-technology/bank-verification/fallbacks.md)。


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