> ## 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（实时 KYT）

> Didit 提供实时交易筛查，支持基于规则的评分、交易频率检查、AML 与案件管理。每月包含 1,000 笔交易，之后每笔 $0.001。

Didit 的交易监控功能允许您借助可配置的规则引擎，对每笔转入和转出的交易进行实时筛查。每笔交易都会获得一个风险评分，规则可根据您设定的阈值自动批准、标记待审核或拒绝该交易。

本 Didit Academy 课程将结合实时数据，带您了解规则引擎：交易数据流、风险评分的计算方式、使用触发器和条件创建规则、回测，以及开启加密货币监控。

[实时拦截欺诈：规则引擎（Didit Academy）](https://www.youtube.com/embed/Yhm63_n7HuU?rel=0\&playsinline=1)

初次使用 Didit TM？请先阅读[快速入门](https://docs.didit.me/zh/transaction-monitoring/quickstart.md)，用 10 分钟完成设置，再阅读[集成指南](https://docs.didit.me/zh/transaction-monitoring/integration-guide.md)了解架构和生产环境模式。[风险评分](https://docs.didit.me/zh/transaction-monitoring/risk-scoring.md)详细说明了评分的计算方式。

## 工作原理

**1. 提交交易**

通过[创建交易](https://docs.didit.me/zh/management-api/transactions/create.md) API 提交交易数据。每笔交易包括主体方和交易对手方、财务详情（金额、币种、方向）、支付方式信息，以及可选的设备上下文和用于规则评估的自定义属性。

Didit 支持多种交易类别，涵盖从标准金融交易到博彩事件、Travel Rule 转账和审计追踪条目。完整的 payload 参考请见[提交交易](https://docs.didit.me/zh/transaction-monitoring/transactions.md)。

**2. 规则引擎评估**

Didit 会针对您应用中所有生效的规则运行该交易。规则可检查以下内容：

* **单笔交易阈值**：金额限制、高风险国家/地区、黑名单实体
* **时间窗口**：一段时间内的累计金额或笔数（例如 24 小时内超过 \$10,000）
* **行为模式**：拆分交易检测、快速转入转出、整数金额模式
* **AML 筛查**：通过外部服务商对交易对手和关联用户进行制裁与观察名单检查
* **钱包风险**：混币器风险敞口、高风险地址（适用于加密货币交易）

每条匹配的规则都会计入该交易的整体风险评分。

**3. 评分并决策**

根据累计评分和严重程度最高的规则匹配结果，交易将获得一个状态：

| 状态 | 含义 |
| - | - |
| `APPROVED` | 低于所有阈值，交易正常 |
| `IN_REVIEW` | 已标记，等待分析师人工审核 |
| `DECLINED` | 被某条规则自动拒绝 |
| `AWAITING_USER` | 需要用户进行额外验证 |

当交易进入 `AWAITING_USER` 时，Didit 会自动创建关联的补救会话，并返回验证 URL，以便您无需离开交易工作区即可继续流程。

**4. 监控与调查**

使用 Business Console 或 API 执行以下操作：

* 查看被标记的交易及完整上下文（评分、匹配的规则、关联方）
* 开启调查案件并分配分析师
* 跟踪分析师绩效和处理时长
* 导出交易数据用于合规报告

## 加密货币筛查

对于加密货币交易，Didit 会自动将地址和交易哈希与区块链分析服务商（Crystal、Merkle Science 等）进行筛查。筛查在交易创建时于服务端运行，您无需额外调用 API。

每次筛查都会生成标准化的风险评分、包含风险敞口类别细分的资金来源分析、风险敞口表，以及交互式网络图谱。结果会直接输入规则引擎，“制裁交易对手”和“暗网市场风险敞口”等预设规则会自动触发。

有关服务商详情、定价、风险敞口类别和网络可视化，请参阅[加密货币筛查](https://docs.didit.me/zh/transaction-monitoring/aml-screening.md)。

## 主要功能

| 功能 | 说明 |
| - | - |
| **实时评分** | 每笔交易都会立即根据所有生效规则进行评分 |
| **内置规则库** | 预配置规则，涵盖 AML/CTF、欺诈、加密货币、负责任博彩和区块链分析 |
| **自定义规则** | 在控制台中构建规则，包含条件、时间窗口、范围和自动化操作 |
| **加密货币筛查** | 通过 Crystal、Merkle Science 等进行钱包和交易的自动筛查 |
| **资金来源分析** | 细分资金来源：交易所、混币器、受制裁实体、诈骗 |
| **交易对手关联** | 实体层面，查看钱包曾与哪些实体发生过交易 |
| **网络图谱** | 交互式可视化图谱，展示钱包关系和资金流向 |
| **Travel Rule 合规** | 跟踪虚拟资产转账的汇款人和收款人数据、协议详情及义务状态 |
| **补救工作流** | 当规则要求额外检查时，自动触发用户验证 |
| **案件管理** | 开启案件，关联警报和交易，分配分析师，并附加证据 |
| **可配置设置** | 按应用调整评分阈值、默认币种、服务商偏好和补救工作流 |
| **Webhook** | 通过 [Webhook](https://docs.didit.me/zh/integration/webhooks.md) 实时接收 `transaction.created`、`transaction.status.updated` 和 `travel_rule.status.updated` 事件 |

## 集成

通过 API 提交交易，并通过 Webhook 接收结果：

```bash theme={null}
curl -X POST https://verification.didit.me/v3/transactions/ \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "transaction_id": "finance0001",
    "transaction_category": "finance",
    "transaction_details": {
      "direction": "outbound",
      "amount": "1200.00",
      "currency": "EUR"
    },
    "subject": { "entity_type": "person", "vendor_data": "user-123", "full_name": "John Doe" },
    "counterparty": { "entity_type": "person", "full_name": "Jane Doe" }
  }'
```

查看 [API 参考](https://docs.didit.me/zh/management-api/transactions/create.md)了解完整的 payload 结构。

## 定价

您的套餐每月包含一定数量的受监控交易：Free 套餐为 1,000 笔，Growth 套餐为 10,000 笔，Scale 套餐为 100,000 笔，Enterprise 套餐的数量由您的合同设定。超出额度的每笔交易按 $0.001 的标准价格计费，再扣除套餐折扣：Free 和 Growth 套餐为 $0.001，Scale 套餐为 \$0.0009。

额度以组织为单位计算，每月 1 日重置，且不可结转。当您用量达到 80% 和 100% 时，Didit 会通知您。

对交易进行加密货币钱包筛查，以及对交易各方进行 AML 筛查，均保留各自的价格。查看所有费率，请参阅[定价](https://docs.didit.me/zh/getting-started/pricing.md#交易监控-kyt)。

## 后续步骤

> [card] [提交交易](https://docs.didit.me/zh/transaction-monitoring/transactions.md)
>
> Create Transaction API 的完整 payload 参考。

> [card] [规则与评分](https://docs.didit.me/zh/transaction-monitoring/rules.md)
>
> 规则引擎的工作原理、内置规则包以及自定义规则的创建。

> [card] [事件接入](https://docs.didit.me/zh/transaction-monitoring/events.md)
>
> 将登录、游戏操作、奖励、支付和争议事件发送到同一引擎。

> [card] [加密货币筛查](https://docs.didit.me/zh/transaction-monitoring/aml-screening.md)
>
> 钱包筛查、资金来源和网络可视化。

> [card] [Travel Rule](https://docs.didit.me/zh/transaction-monitoring/travel-rule.md)
>
> 用于虚拟资产转移的 Travel Rule 合规数据。

> [card] [案件与调查](https://docs.didit.me/zh/transaction-monitoring/cases.md)
>
> 打开案件、分配分析师并管理调查工作流。

> [card] [设置](https://docs.didit.me/zh/transaction-monitoring/settings.md)
>
> 评分阈值、服务提供商和整改配置。


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