风控信息字段规范
更新时间:2025.05.19商户在发起支付请求时传入风控信息字段,用于实时识别高风险交易,提升支付安全性及交易成功率。
格式范例
ip:202.106.196.115;last_oid:ox6zi6jKVxWVxxxx-xWlkMxxxx7E;device:%27Android%3B12%3BHUAWEI%3BADA-AL00%27;
具体要求
1. 风险字段说明
字段名 | 说明 | 示例 | 注意事项 |
---|---|---|---|
| 用户下单的 IP 地址,支持 IPv4/IPv6。 | IPv4: | 确保为公网地址,避免使用内网或服务器地址。 |
| 用户最近一次支付成功的 OpenID,新用户传空值。 |
| 新用户传空值,例如: |
| 设备信息,包含操作系统类型、版本、厂商、型号等,用''包裹,内部信息间用;间隔。 |
| 设备信息中的特殊字符必须进行 URL 编码,以确保字段解析的正确性。 |
2. 字段分隔与编码规则
多字段分隔符
不同字段(
ip
、last_oid
、device
)之间用;
分隔。示例:
ip:...;last_oid:...;device:...;
内部字段的分隔与编码
每个字段内部用
:
分隔键值对。示例:
ip:202.106.196.115
如果值中包含特殊字符(如
'
、:
、;
、空格等),需进行 URL 编码(RFC 3986)。示例:
IPv6 地址
2606:4700:4700:1111
编码为2606%3A4700%3A4700%3A1111
设备信息
'Android;12;HUAWEI;ADA-AL00'
编码为%27Android%3B12%3BHUAWEI%3BADA-AL00%27