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

# 交易监控快速入门：10分钟完成设置

> 10 分钟内提交首笔交易、查看规则触发并配置 Webhook。Didit 每月包含 1,000 笔交易，之后每笔 $0.001。

在 10 分钟内完成交易监控的搭建。您将提交一笔测试交易，查看其评分，启用一条预设规则，重新提交以观察规则触发，并确认 Webhook 已成功送达。

## 前提条件

* 已启用交易监控的 Didit 应用（*Settings → Transaction Monitoring → Enable*）。
* 一个 API 密钥。
* 一个可从互联网访问的 Webhook endpoint。

## 步骤

**1. 提交基线交易**

```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": "baseline-0001",
    "transaction_category": "finance",
    "transaction_details": {
      "direction": "outbound",
      "amount": "500.00",
      "currency": "EUR"
    },
    "subject": { "entity_type": "person", "vendor_data": "user-42", "full_name": "Jane Doe" },
    "counterparty": { "entity_type": "company", "full_name": "Acme Supplier" }
  }'
```

响应包含：

* `status`：`APPROVED` 表示未触发任何规则，`IN_REVIEW` / `DECLINED` 表示至少触发了一条规则。
* `score`：整数，范围 0–100+。
* `rule_runs`：由评估过该交易的所有规则组成的数组。

**2. 启用预设规则**

在 Business Console 中进入 *Transactions → Rules → Library*。选择一个预设，例如 **拆分交易（转出）**：当同一用户在 30 天内发起 20+ 笔低于 €10,000 的转出交易时触发。启用并保存。

**3. 提交触发该规则的交易**

快速为同一用户提交 20 笔交易，每笔金额均低于 €10,000：

```bash theme={null}
for i in $(seq 1 20); do
  curl -X POST https://verification.didit.me/v3/transactions/ \
    -H "x-api-key: YOUR_API_KEY" \
    -H "Content-Type: application/json" \
    -d "{
      \"transaction_id\": \"struct-$i\",
      \"transaction_category\": \"finance\",
      \"transaction_details\": {
        \"direction\": \"outbound\",
        \"amount\": \"9500.00\",
        \"currency\": \"EUR\"
      },
      \"subject\": { \"entity_type\": \"person\", \"vendor_data\": \"user-42\", \"full_name\": \"Jane Doe\" },
      \"counterparty\": { \"entity_type\": \"company\", \"full_name\": \"Shell Co $i\" }
    }"
done
```

提交第 20 笔交易时，拆分交易规则被触发。该交易返回 `status: IN_REVIEW`，`score` 反映该规则的 `score_delta`。

**4. 订阅交易 Webhook**

```bash theme={null}
curl -X POST https://verification.didit.me/v3/webhook/destinations/ \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "label": "TM events",
    "url": "https://yourapp.com/webhooks/didit-tm",
    "subscribed_events": ["transaction.created", "transaction.status.updated"]
  }'
```

响应包含 `secret_shared_key`，请立即将其保存为 `.env` 文件中的 `DIDIT_WEBHOOK_SECRET`：

```bash theme={null}
DIDIT_WEBHOOK_SECRET=whsec_...   # signing secret returned from webhook registration
```

然后，在信任任何传入的 Webhook 之前，请对每个请求验证 `X-Signature-V2` HMAC（对规范化后的请求体重新计算 HMAC-SHA256，使用恒定时间比较，并拒绝过期的时间戳）。有关payload和完整验证代码，请参阅 [交易监控 Webhook](https://docs.didit.me/zh/transaction-monitoring/webhooks.md)。

此后每笔交易都会实时推送到您的端点。

**5. 在控制台中查看**

在控制台中进入 *Transactions*：

* 列表视图：近期交易、过滤器、批量操作。
* 交易详情：规则运行记录、IP 信息增强、当事方详情、网络图谱（适用于加密货币）、关联的警报和案件。

**6. 通过 API 获取交易**

```bash theme={null}
curl https://verification.didit.me/v3/transactions/{transaction_id}/ \
  -H "x-api-key: YOUR_API_KEY"
```

返回完整的[响应架构](https://docs.didit.me/zh/transaction-monitoring/response-schema.md)，包括评分、匹配的规则、当事方信息补充、AML 筛查结果等。

## 您刚刚完成的设置

* **实时评分**：每笔交易都会经过每一条启用的规则。
* **AML 筛查**：交易对手会自动与制裁和负面新闻进行比对。
* **IP 信息增强**：每笔交易都会补充 IP 所在国家/地区、ASN 以及 VPN/Tor 标记。
* **Webhook**：每笔交易都会实时发送通知。
* **审计记录**：规则运行记录、警报和状态变更均可在控制台中查询。

## 后续常见操作

> [card] [集成指南](https://docs.didit.me/zh/transaction-monitoring/integration-guide.md)
>
> 完整的架构与模式。

> [card] [规则详解](https://docs.didit.me/zh/transaction-monitoring/rules.md)
>
> 规则的工作方式、条件、聚合和操作。

> [card] [风险评分](https://docs.didit.me/zh/transaction-monitoring/risk-scoring.md)
>
> 评分如何组合为状态。

> [card] [交易 payload](https://docs.didit.me/zh/transaction-monitoring/transactions.md)
>
> 完整的交易提交架构。

> [card] [状态](https://docs.didit.me/zh/transaction-monitoring/statuses.md)
>
> 交易、警报和案件的状态。

> [card] [案件](https://docs.didit.me/zh/transaction-monitoring/cases.md)
>
> 调查并解决。


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