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

前提条件

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

步骤

1

提交基线交易

响应包含:
  • status:APPROVED 表示未触发任何规则,IN_REVIEW / DECLINED 表示至少触发了一条规则。
  • score:整数,范围 0–100+。
  • rule_runs:由评估过该交易的所有规则组成的数组。
2

启用预设规则

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

提交触发该规则的交易

快速为同一用户提交 20 笔交易,每笔金额均低于 €10,000:
提交第 20 笔交易时,拆分交易规则被触发。该交易返回 status: IN_REVIEW,score 反映该规则的 score_delta。
4

订阅交易 Webhook

响应包含 secret_shared_key,请立即将其保存为 .env 文件中的 DIDIT_WEBHOOK_SECRET:
然后,在信任任何传入的 Webhook 之前,请对每个请求验证 X-Signature-V2 HMAC(对规范化后的请求体重新计算 HMAC-SHA256,使用恒定时间比较,并拒绝过期的时间戳)。有关payload和完整验证代码,请参阅 交易监控 Webhook。此后每笔交易都会实时推送到您的端点。
5

在控制台中查看

在控制台中进入 Transactions:
  • 列表视图:近期交易、过滤器、批量操作。
  • 交易详情:规则运行记录、IP 信息增强、当事方详情、网络图谱(适用于加密货币)、关联的警报和案件。
6

通过 API 获取交易

返回完整的响应架构,包括评分、匹配的规则、当事方信息补充、AML 筛查结果等。

您刚刚完成的设置

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

后续常见操作

集成指南

完整的架构与模式。

规则详解

规则的工作方式、条件、聚合和操作。

风险评分

评分如何组合为状态。

交易 payload

完整的交易提交架构。

状态

交易、警报和案件的状态。

案件

调查并解决。
最后修改于 2026年11月7日