跳转到主要内容
交易监控有三套独立的状态机:交易、每个案件,以及(适用时)Travel Rule 核验。本页为参考手册。

交易状态

在创建时设置,并随生命周期更新。

状态流转

注:除 Travel Rule 外,APPROVED 或 DECLINED 不会直接转换为其他状态。 Travel Rule 过期时,无论当前状态如何,您的 timeout_outcome 都会将状态设为 IN_REVIEW(HOLD)或 DECLINED(REJECT)。在 Travel Rule 状态转换之后触发的规则,可能会更改 APPROVED 交易。 如需更正,请通过控制台使用状态补丁;这些更正会记入审计日志。

警报

没有单独的警报状态。 处于打开状态的警报就是 IN_REVIEW 或 AWAITING_USER 状态的交易,因此请使用上述交易状态。 参见 警报。

案件状态

完整说明参见 案件管理。 案件另有 优先级(LOW、MEDIUM、HIGH)。

Travel Rule 核验状态

根据 FATF Travel Rule 进行的虚拟资产转账会运行专门的 13 状态交换流程,它与上述交易状态相互独立。 出站转账的起始状态为 AWAITING_COUNTERPARTY、NOT_APPLICABLE(低于 threshold_amount)、UNCONFIRMED_OWNERSHIP(对方钱包声明为自托管)、COMPLETED,或 COUNTERPARTY_MISMATCHED_DATA(在已验证钱包上进行 INTERNAL 匹配,取决于姓名匹配结果),也可能是 COUNTERPARTY_VASP_NOT_FOUND 或 COUNTERPARTY_VASP_NOT_REACHABLE。 入站转账也可能以 ON_HOLD 或 NOT_ENOUGH_COUNTERPARTY_DATA 起始。与已验证钱包匹配、且收款人姓名相符或缺失的 sunrise 注册,会直接经由 COMPLETED 进入 FINISHED。 交换以 FINISHED、CANCELLED 或 EXPIRED 结束。 较早的集成可能仍会发送旧版值 UNKNOWN、COMPLIANT、PENDING_ACTION、PENDING_COUNTERPARTY、FAILED 和 EXEMPT;Didit 会自动将它们映射到上述状态。 权威参考请见 Travel Rule。

提供方结果状态

每个外部提供方的结果(钱包筛查、法币监控、制裁筛查)都会按其自身状态存储,并在交易响应的 provider_results[] 中返回。

规则运行结果

每个 TransactionRuleRun 包含以下字段:
  • matched(布尔值):规则是否触发?
  • is_test(布尔值):规则是否处于 TEST 模式?
  • mode:评估时的模式,即 ACTIVE、DISABLED 或 TEST。
  • score_delta:对分数的贡献(仅当已匹配且处于启用状态时)。
  • status_target:规则请求的状态(仅当操作为 change_status 时)。
有关规则结构,请参阅 规则。

决策原因代码

状态转换时常见的 reason 值:

后续步骤

风险评分

分数如何映射到状态。

警报

警报生命周期。

案件

案件生命周期。
最后修改于 2026年11月7日