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

# 企业黑名单：屏蔽 KYB 企业与国家/地区

> 通过 vendor_data 或国家/地区屏蔽 Didit 企业：说明屏蔽的检查方式，以及用于添加或移除屏蔽的控制台和 API 路径。

黑名单可阻止未通过合规检查的企业，或位于危险司法辖区的企业，发起新的企业验证（KYB）会话，或在您的平台上开展交易。

## 支持的企业标识符类型

| 类型 | 键 | 匹配条件 |
| - | - | - |
| 企业 | `BUSINESS` | 新会话或交易使用了已加入黑名单的 `vendor_data` |
| 国家/地区 | （单独配置） | 企业所在国家/地区与危险国家/地区列表匹配 |
| IP | `IP_ADDRESS` | 提交者的 IP（或 CIDR 网段）匹配 |
| 设备指纹 | `DEVICE_FINGERPRINT` | 提交者设备匹配 |
| 钱包地址 | `WALLET_ADDRESS` | 与企业关联的加密钱包匹配 |
| 银行账户 | `BANK_ACCOUNT` | IBAN 或银行账户匹配 |

> [!NOTE]
>
> 人脸和证件黑名单在**个人**（用户）层级运行，而非企业层级。若要拦截董事或实际受益人，请将其作为用户加入黑名单。之后，该用户参与的任何企业都会在其关键人员审核中体现这一关联。

## 黑名单的生效方式

> [!NOTE]
>
> 被拒绝的企业验证（KYB）会话不会将企业加入黑名单。会话状态变为 `Declined`，企业状态保持 `ACTIVE`，也不会写入任何名单条目。加入黑名单是手动步骤：您可以通过[黑名单页面](https://docs.didit.me/zh/console/blocklist-users.md)或使用 [Lists API](https://docs.didit.me/zh/management-api/lists/overview.md) 添加条目。`BUSINESS` 类型的条目（即 `vendor_data`）还会将企业状态设为 `BLOCKED`。

**1. 自动：命中危险国家/地区**

若企业注册国家/地区出现在您配置的危险国家/地区列表中，企业验证（KYB）会话将被拒绝。

**2. 自动：命中制裁实体**

企业 AML 命中高于拒绝阈值时，会话将被拒绝。系统不会写入名单条目；如果您希望此后拒绝该企业的 `vendor_data`，请自行将其加入黑名单。

**3. 手动：通过控制台**

分析师可从 *Businesses → \[business] → Actions → Add to blocklist* 将企业加入黑名单。

**4. 程序化：通过 Lists API**

使用 [Lists API](https://docs.didit.me/zh/management-api/lists/overview.md) 直接向企业黑名单添加条目。

## 危险国家/地区

每个应用默认附带一份**危险国家/地区**列表（可在 *Settings → Blocklist → Countries* 中配置）。默认包含的 ISO 代码示例：`IRN`、`PRK`、`SYR`、`AFG`、`RUS`、`MMR`（可能变动，默认列表遵循 FATF 和 OFAC 指引）。

当使用匹配的 `country_code` 创建企业时：

* 企业验证（KYB）会话被拒绝。
* 不会签发会话链接。
* 企业实体以 `BLOCKED` 状态创建。

## 通过 API 将企业加入黑名单

使用 [Lists API](https://docs.didit.me/zh/management-api/lists/overview.md) 以编程方式添加黑名单条目：

1. [列出所有名单](https://docs.didit.me/zh/management-api/lists/list.md)，按 `entry_type=business` 和 `is_system=true` 过滤，以找到系统企业黑名单。
2. [在该名单中创建条目](https://docs.didit.me/zh/management-api/lists/create-entry.md)，将 `value` 设为企业的 `vendor_data`，并可选填 `display_label` 和 `comment` 以供审计使用。

## 交易时的执行

已加入黑名单的企业会自动同步到交易监控中：

* 涉及黑名单申请方企业的交易会被自动拒绝。
* 涉及黑名单交易对手企业的交易，会根据您的规则配置被标记或拒绝。

“Sanctioned counterparty”等预设规则会在这些匹配项出现时触发。

## 将企业移出黑名单

* **控制台**：*Blocklist → Businesses → row actions → Remove*。
* **API**：使用 [Delete entry](https://docs.didit.me/zh/management-api/lists/delete-entry.md) 端点，并提供名单 UUID 和条目 UUID。

移出黑名单不会自动更改企业的 `status`。请使用 `PATCH /v3/businesses/{vendor_data}/update-status/` 将企业恢复为 `ACTIVE`。

## 审计追踪

每次加入或移出黑名单的操作都会记录到[审计日志](https://docs.didit.me/zh/console/audit-logs.md)中，包含：

* 操作者（用户邮箱，或 `'system'`、`'api'`）。
* 时间戳。
* 可选备注。
* 若为自动生成，则附带关联会话。

## 后续步骤

> [card] [Lists API](https://docs.didit.me/zh/management-api/lists/overview.md)
>
> 完整的黑名单 API 参考。

> [card] [控制台黑名单](https://docs.didit.me/zh/console/blocklist-users.md)
>
> 在界面中管理黑名单。

> [card] [运营](https://docs.didit.me/zh/entities/businesses/operations.md)
>
> 更改企业状态。


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