MaxMind minFraud Factors:原因代码、定价与用法
早上打开待审核队列,您把两笔订单并排查看。两笔订单的分数都在 1 左右,稳稳落在接受范围内,而且都是被抽样规则挑出后进入队列的。客户信息看起来都很普通,支付金额也相近。单看分数,很难区分两笔订单,初步审核时,它们几乎像是同一个决策。再看每笔结果附带的原因,您会发现,两笔订单的分数来自不同的信号组合。如果分数几乎相同,背后的证据能告诉您什么?
Factors 返回内容与定价
Factors 返回Insights 的全部内容,并附上分数原因。每条原因都有一个代码。MaxMind 会提供一句说明,并给出 0.01 到 100 的乘数。乘数大于 1 会提高分数,小于 1 则会降低分数。
从 Score 到 Insights,再到 Factors,每次升级都会增加单次查询的费用。Factors 是三者中费用最高的服务。当前价格请查看 MaxMind 定价页面。
原因码取代了旧版子评分。MaxMind 于 2024年10月弃用了旧版子评分,并在发布说明中宣布将在 2025年3月移除子评分。
比较 minFraud 评分
在 2026年10月5日的测试中,同一笔订单分别通过 Score、Insights 和 Factors 调用,进行了三轮。每轮的调用顺序都不同,九次调用返回的分数都是 0.93。Factors 每次返回的原因也相同。
此前的调用间隔了几分钟,返回的分数有所不同。这段时间里,网络记录发生了变化。在这次同一时刻的测试中,Factors 多出的费用买到的是原因信息,分数本身没有变化。
审核评分原因
法兰克福云服务器 IP 对应的订单通过 Factors 得分为 3.08。按 MaxMind 给出的示例接受阈值,即 5.00 或以下,这个分数属于接受范围。Factors 给出的原因是 ANONYMOUS_IP ×12.5。纽约账单地址对应的订单得分为 0.16,带有 ISSUER_ID_NUMBER_COUNTRY_MISMATCH ×4,尽管请求中没有发送银行卡信息。
图表中,布拉格信息一致的订单和收货地址在境外的订单都带有相同的新邮箱原因。布拉格订单有三条拉低分数的原因,最终得分为 0.80。审核人员既能看到哪些因素压低了分数,也能看到哪些因素推高了分数。
原因代码说明
以下是我们调用时返回的代码及 MaxMind 提供的说明:
| 代码 | 原因说明 |
|---|---|
| ANONYMOUS_IP | 匿名 IP 地址推高了总体风险评分 |
| EMAIL_ACTIVITY | 该邮箱在 minFraud 网络中的活动推高了总体风险评分 |
| EMAIL_DOMAIN | 邮箱域名推高或拉低了总体风险评分 |
| EMAIL_FIRST_SEEN | 该邮箱首次出现在 minFraud 网络中,推高了总体风险评分 |
| IP_ACTIVITY | 该 IP 地址在 minFraud 网络中的活动推高了总体风险评分 |
| ISSUER_ID_NUMBER_COUNTRY_MISMATCH | IP、账单地址、收货地址和 IIN 所属国家不一致,推高了总体风险评分 |
| ORG_DISTANCE_RISK | ISP 风险与账单地址到 IP 地址所在位置的距离共同作用,拉低了总体风险评分 |
| SHIP_ACTIVITY | 收货地址在 minFraud 网络中的活动推高或拉低了总体风险评分 |
同一个代码对不同订单的影响可能不同。在一次调用中,EMAIL_DOMAIN 推高了使用一次性邮箱的订单分数,在其他调用中,它则降低了使用业务邮箱地址的订单分数。MaxMind 表示,可按需提供当前代码列表。因此,读取代码的规则需要设置一个分支,用来处理未知代码。
在决策中使用原因
- 调用 Factors 前,先运行自己的检查。
- 在审核人员查看分数时,同时展示原因。
- 当某个代码本身就是决策依据时,可将其用作规则条件,例如 ANONYMOUS_IP。
- 为每条读取代码的规则设置一个分支,处理未知代码。
- 将乘数理解为分数的权重,而不是其本身代表的概率。
- 确定规则如何处理调用失败的情况。数据源调用失败时,返回的值会缺失并附带错误标记。只有标记为可重复的数据源才会重试。
- 通过 MaxMind 的 交易报告 API 回传交易结果。
适用场景
创建账户
创建账户时,如果单看分数无法判断分数为何上升,原因可以为审核人员提供背景信息。MaxMind 支持将账户创建作为事件类型。
结账与支付
结账时,ANONYMOUS_IP 这类代码可以直接作为规则判断条件。订单进入审核后,审核人员也可以在分数旁查看原因。
贷款审批
处理信贷申请时,原因可以作为审核参考。如果流程要求向申请人说明结果,说明内容应解释您的决策。MaxMind 的原因说明的是它对评分的判断。
常见问题
原因代码列表固定吗?
MaxMind 只按需提供当前代码列表,因此读取代码的规则需要设置一个分支,处理尚未见过的代码。
可以向客户展示原因吗?
原因说明的是 MaxMind 对分数上升或下降的判断。可以按这个含义向客户展示,同时要区分 MaxMind 的说明和您自己的决策及解释。
没有发送银行卡信息,为什么原因里提到了银行卡?
我们的调用中,纽约账单地址对应的订单返回了 ISSUER_ID_NUMBER_COUNTRY_MISMATCH ×4,尽管请求中没有银行卡信息。响应没有解释这种情况下出现该原因的原因。
API 错误代表什么?
429 表示请求受到速率限制,没有得到处理。402 表示账户额度已用完。
| 状态码 | 代码 | 含义 |
|---|---|---|
| 400 | JSON_INVALID, REQUEST_INVALID | 请求正文不是 JSON,或没有有效输入 |
| 401 | AUTHORIZATION_INVALID | 账户 ID 或 license key 不正确 |
| 402 | INSUFFICIENT_FUNDS | 账户额度已用完 |
| 403 | PERMISSION_REQUIRED | 账户无权使用此服务 |
| 429 | none | 请求受到速率限制,未得到处理 |
| 500 | SERVER_ERROR | 处理请求时发生错误 |
配置时,将 MaxMind 账户 ID 和 license key 一起保存为 HTTP Basic 凭证。保存凭证后,让助手根据MaxMind 请求文档配置数据源。