> ## 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 获取企业实体的完整交易历史记录，并查看其持续交易活动如何为交易监控的速度规则、行为规则和筛查规则提供数据输入。

您提交的交易中，只要其 `vendor_data` 标识符与某个企业实体匹配（无论该企业是申请人、汇款人、收款人还是交易对手），都会关联到该企业档案。企业会形成一份持续记录其活动的账本，交易监控会利用这些历史记录，在企业层面驱动速率、行为和筛查规则。

## 获取企业的交易记录

按企业的 `vendor_data` 筛选 Transactions 列表：

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

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

## 交易如何关联企业

```mermaid theme={null}
flowchart LR
    T["Transaction<br/>txn_id=tx-0042"]
    A["applicant:<br/>vendor_data=biz-acme"]
    C["counterparty:<br/>vendor_data=biz-widgets"]
    B1[Business: biz-acme]
    B2[Business: biz-widgets]
    T --> A
    T --> C
    A -.-> B1
    C -.-> B2
```

每笔交易最多包含四方（`applicant`、`remitter`、`beneficiary`、`counterparty`）。当某一方包含的 `vendor_data` 与您应用中的某个企业实体匹配时，Didit 会将该方绑定到该企业。未包含 `vendor_data` 的各方会以外部快照形式存储，不与任何实体关联。

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

## 混合参与方类型

同一笔交易的各方可以同时包含用户和企业，例如个人用户向企业付款：

```json theme={null}
{
  "txn_id": "tx-0099",
  "direction": "OUTBOUND",
  "amount": "500.00",
  "currency": "EUR",
  "applicant": { "vendor_data": "user-42" },
  "counterparty": { "vendor_data": "biz-acme" }
}
```

或者两家企业之间的 B2B 转账：

```json theme={null}
{
  "txn_id": "tx-0100",
  "direction": "OUTBOUND",
  "amount": "120000.00",
  "currency": "USD",
  "applicant": { "vendor_data": "biz-acme" },
  "counterparty": { "vendor_data": "biz-widgets" }
}
```

Didit 会根据 `vendor_data` 分别识别每一方，同一笔交易会同步进入每个匹配实体的档案。

## 聚合风险信号

交易会为以下企业层面的信号提供数据：

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

这些信号实时计算，并与您当前生效的[交易规则](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` 状态，并触发 `business.status.updated` Webhook。

## 监控企业行为

在 Business Console 的企业详情页中使用 Transactions 标签页，可以：

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

## 企业拥有的支付方式

每笔交易可以关联一种或多种支付方式（银行卡、银行账户、电子钱包、加密钱包）。当某个支付方式归企业所有时，它会通过 `vendor_data` 关联回该企业，因此您可以直接在企业详情页中查看该企业历史上使用过的所有支付方式。

## 历史数据导入

要为已有企业回溯导入历史交易，请传入过去的 `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": "25000.00",
    "currency": "EUR",
    "applicant": { "vendor_data": "biz-acme" },
    "counterparty": { "name": "Historic payer" }
  }'
```

> [!NOTE]
>
> 历史交易仍会经过规则引擎处理。如果您希望导入历史记录**且不触发规则**，请使用控制台的导入流程，该流程支持“试运行导入”模式。

## 后续步骤

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