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

# 用户交易记录：KYT 历史与风险查询

> 通过 Didit 获取用户实体的交易历史，并查看 Didit 如何将其用于交易监控规则。每月包含 1,000 次，之后每次 $0.001。

您提交的每笔交易如果包含 `vendor_data` 标识符（无论作为申请人还是交易对手），都会关联到对应的用户实体。用户资料会成为该用户活动的持续台账，交易监控会利用这一历史记录来支持速率规则和行为规则。

## 获取用户的交易

按 `vendor_data` 筛选交易列表：

```bash theme={null}
curl -G https://verification.didit.me/v3/transactions/ \
  -H "x-api-key: YOUR_API_KEY" \
  --data-urlencode "vendor_data=user-42" \
  --data-urlencode "page_size=50"
```

返回该用户作为申请人的所有交易。如需查看用户作为交易对手的历史记录，请在 Business Console 中筛选（公开列表 endpoint 仅按申请人筛选）。

## 交易如何关联用户

```mermaid theme={null}
flowchart LR
    T["Transaction<br/>txn_id=tx-0001"]
    A["applicant:<br/>vendor_data=user-42"]
    C["counterparty:<br/>vendor_data=user-99"]
    U1[User: user-42]
    U2[User: user-99]
    T --> A
    T --> C
    A -.-> U1
    C -.-> U2
```

每笔交易最多包含四个参与方：申请人、汇款人、收款人和交易对手。当某个参与方包含 `vendor_data` 时，Didit 会将其绑定到对应的用户。不包含 `vendor_data` 的参与方会作为外部快照存储，不与任何用户实体关联。

有关完整的参与方模型，请参阅[提交交易](https://docs.didit.me/zh/transaction-monitoring/transactions.md)。

## 聚合风险信号

交易会为以下用户级信号提供数据：

| 信号 | 使用方 |
| - | - |
| 流入 / 流出总金额 | 速率规则、阈值判定 |
| 时间窗口内的交易笔数 | 速率规则 |
| 不同的交易对手数量 | 行为规则 |
| 涉及的高风险司法管辖区 | 地理规则 |
| 受制裁交易对手风险敞口 | 筛查规则 |
| 支付方式多样性 | 欺诈规则 |

这些信号实时计算，并与您启用的[交易规则](https://docs.didit.me/zh/transaction-monitoring/rules.md)进行比对。规则匹配时，用户会根据规则的操作自动转为 `FLAGGED` 或 `BLOCKED` 状态。

## 规则如何作用于用户

交易规则的 `actions` 可以包括：

* `add_score`：提高交易的风险评分。
* `change_status`：设置交易的状态（`IN_REVIEW`、`DECLINED`、`AWAITING_USER`）。
* `add_tags`：为交易添加标签。
* `add_to_list`：将用户的 `vendor_data` 添加到黑名单或自定义名单。

当规则将用户加入黑名单时，其用户实体会转为 `BLOCKED` 状态，并触发 `user.status.updated` Webhook 事件。

## 监控用户行为

在 Business Console 的用户详情页中使用交易标签页，您可以：

* 按时间顺序查看每笔交易。
* 按状态、金额、方向、交易对手进行筛选。
* 打开任意交易，查看规则运行记录、IP 增强信息和加密货币筛查结果。
* 针对该用户创建案件，跟踪调查进展。

## 整改会话

当交易进入 `AWAITING_USER` 状态时，Didit 会创建一个关联的**整改会话**，要求用户完成额外验证（例如提供资金来源证明或更新身份证件）。整改会话与同一 `vendor_data` 绑定，用户完成后，交易状态会自动更新。

有关完整的状态流转，请参阅[交易状态](https://docs.didit.me/zh/transaction-monitoring/statuses.md)。

## 历史数据导入

如需为已有的用户实体补录历史交易，请传入过去的 `txn_date`：

```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 '{
    "txn_id": "legacy-0001",
    "txn_date": "2024-03-15T10:00:00Z",
    "direction": "INBOUND",
    "amount": "2500.00",
    "currency": "EUR",
    "applicant": { "vendor_data": "user-42" },
    "counterparty": { "name": "Historic payer" }
  }'
```

> [!NOTE]
>
> 历史交易仍会经过规则引擎处理。如果您希望在**不触发规则**的情况下导入历史数据，请使用支持“dry ingest”模式的控制台导入流程。

## 后续步骤

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

> [card] [规则](https://docs.didit.me/zh/transaction-monitoring/rules.md)
>
> 规则如何评估交易并作用于用户。

> [card] [状态](https://docs.didit.me/zh/transaction-monitoring/statuses.md)
>
> 交易和整改状态参考。


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