ACTIVE、TEST 或 DISABLED)。预设的条件、阈值和操作是固定的;如需不同的逻辑,请构建自定义规则。卸载某个预设即可将其从应用中移除,需要时可以随时重新安装。
可以在 Business Console 的 Transactions -> Rules -> Library 中浏览、安装和卸载规则库规则,也可以通过规则库 API(
GET /v3/transactions/rules/library/,POST/DELETE /v3/transactions/rules/install/),或通过 didit_transaction_rule_library_list / didit_transaction_rule_install / didit_transaction_rule_uninstall MCP 工具进行操作。已安装的预设仅支持修改 mode(启用、禁用、测试);其阈值是固定的,如需覆盖,请构建自定义规则。关于规则如何影响评分,请参阅风险评分。如果规则的条件所读取的数据,规则引擎尚无法评估,该规则将被暂缓,直到可以运行为止:规则库不会列出它,在
library_keys 中指定它的请求会返回 400 且不安装任何内容(若指定的是未知键,则会跳过该键),bundle 安装也会跳过它。您此前已安装的副本会被关闭(DISABLED),并保留在您的规则列表中,将其 mode 设置为其他任何值都会返回 400。当规则引擎能够评估其条件后,被暂缓的规则会自动恢复,因此规则库列表始终只显示您当前可以安装的规则。预设的组织方式
每个预设都属于一个套件(其功能类别)和一个类别(其更宽泛的风险主题)。套件让您可以在控制台中一起切换相关规则;类别则用于评分和报表。如何阅读本页
每条规则都列出其library_key(稳定标识符,可在 API 或控制台 URL 中引用)、触发该规则的条件与聚合方式,以及默认操作。此处显示的数值阈值为出厂默认值,每个值都可以按应用单独编辑,且不影响规则的标识。
金融类规则包
这些规则适用于每一笔transaction_type = FINANCE 的交易。它们以监管基线为依据(BSA/FinCEN 申报阈值、FATF 资金流速启发式规则),并覆盖资金骡和化整为零的模式。
拆分交易与接近阈值
交易量与频率
分层转移、资金骡与化整为零
行为异常
AML / CTF 规则包
这些规则涵盖经典的 AML/CTF 类型,不依赖区块链数据增强,适用于法币转账和加密货币转账。
默认的高风险司法辖区名单包含 FATF 行动呼吁名单及冲突地区,即:
IRN、PRK、SYR、AFG、RUS、MMR。您可以按应用覆盖此名单。
当前不提供政治公众人物(PEP)交易对手筛查支持。 目前没有任何已接入的筛查服务商会报告交易对手是否为政治公众人物:截至目前,每个筛查结果中的
pep_counterparty 字段都为 null(参见钱包筛查),因此规则库不包含 PEP 交易对手预设。在该预设下架之前安装的规则会继续评估,但无法匹配到真实的筛查结果。如需针对其他信号采取行动,请删除该规则,或改用自定义规则替换它。加密货币筛查规则包
这些规则使用 Didit 加密货币筛查生成的增强数据,最适用于加密原生应用和 VASP 应用。加密货币监控套件
钱包层面的风险暴露规则,以及与 VASP 和 Travel Rule 相关的完整性检查。Travel Rule 套件
Travel Rule 规则仅适用于travelRule 交易。
每个地区监管制度各附带四条规则(待交易对手处理、待操作、数据缺失、交换失败)。
全球 Travel Rule
地区监管制度
同一套四条规则模板适用于每个监管制度。将下方的<regime> 替换为以下任一值:australia、dubai、eu、hong_kong、india、indonesia、japan、kazakhstan、singapore、south_africa、turkey、uk。
监管制度标记为自动完成:Didit 会根据您在 Travel Rule 设置 中的 jurisdiction,为每笔 Travel Rule 交易在 custom_values.travel_rule_regime 中写入标记:SG → singapore,GB → uk,任何欧盟或欧洲经济区成员国代码(如 DE 或 FR)→ eu。没有地区套件的代码会以小写形式写入(US → us),因此自定义规则仍可针对它们设置。在交易中提交的 props.travel_rule_regime 值始终覆盖推导出的监管制度。
除上述三条全球 Travel Rule 规则和下方五条交易对手规则外,另有 48 条地区专属规则。
单独的
travel_rule_eu_tfr 套件另外提供四条 EU TFR 规则,详见 EU TFR 规则套件。
交易对手尽职调查
这些规则读取您的应用掌握的、交易所联系到的交易对手 VASP 的信息:您对其作出的决定、其尽职调查风险等级、所在国家/地区及其响应情况。 各项数值的来源详见 交易对手尽职调查。设备情报与欺诈防范
这些规则将客户端 SDK(设备指纹、IP、浏览器、会话已持续时间)以及服务商补充信息中的信号,转化为欺诈检测事件。设备指纹与多账户
IP、网络与 VPN
行为复合规则
账户接管与 APP 欺诈
联盟推广与奖励滥用
责任博彩套件
适用于 iGaming 应用。这些规则旨在同时检测玩家保护信号和奖励套利模式。iGaming 欺诈套件
适用于同时发送监控事件和资金流动数据的运营商。这些规则使用scope.record_types = ["event"],因此仅使用交易数据的客户不会有任何行为变化。若存在仅交易回退规则,请在您的集成发送事件类别之前,同时安装对应的回退规则。
每条规则所需的事件信号
上述每条规则都会读取指定的事件字段。若缺少某个必需字段,该规则将不匹配,它绝不会用其他信号进行近似推断,也不会仅凭交易数据进行回退。请在事件payload 和 device_context 中发送下列键名(完整的提交约定见事件,规则字段路径见事件规则)。
当您的集成会发出登录、游戏玩法、奖金、联盟、支付、争议、安全和责任博彩相关事件时,请使用
igaming_fraud 套件。这些规则需要主动启用:将其加入规则库不会为现有应用安装这些规则,也不会改变任何现有客户当前的预设。
电子商务套件
适用于电商平台和商户记录方应用。支票欺诈套件
适用于提交支票存款交易的应用。每条规则由调用方在支票带有已知风险信号时(如洗票、缺失 MICR、序列号列于暗网等)设置的custom_values.check_* 标记触发。
BNPL 套件
适用于先买后付(BNPL)服务商。针对分期借贷,识别第一方欺诈(不还款)和标识符共享模式。参考:库背后的标准
Didit 库中的每个预设都对应一种广泛认可的 AML、欺诈或合规类型。我们主要参考以下标准:
Didit 仅实施已被行业标准接受的类型,并开放每个阈值供您调整。
自定义预设
每个预设都可以:- 调优:按应用修改阈值、时间窗口、分值或操作
- 禁用:将预设切换为
DISABLED模式,它将停止评估,但保留其标识 - 测试:将预设切换为
TEST模式,在影子模式下进行评估,不影响交易结果 - 扩展:创建自定义规则,用于补充或覆盖预设