风控信息字段规范

更新时间:2025.05.19

商户在发起支付请求时传入风控信息字段,用于实时识别高风险交易,提升支付安全性及交易成功率。

格式范例

ip:202.106.196.115;last_oid:ox6zi6jKVxWVxxxx-xWlkMxxxx7E;device:%27Android%3B12%3BHUAWEI%3BADA-AL00%27;

具体要求

1. 风险字段说明

字段名

说明

示例

注意事项

ip

用户下单的 IP 地址,支持 IPv4/IPv6。

IPv4: 202.106.196.115
IPv6: 2606:4700:4700:1111(需编码, 详见下文)

确保为公网地址,避免使用内网或服务器地址。

last_oid

用户最近一次支付成功的 OpenID,新用户传空值。

ox6zi6jKVxWVxxxx-xWlkMxxxx7E

新用户传空值,例如:last_oid:

device

设备信息,包含操作系统类型、版本、厂商、型号等,用''包裹,内部信息间用;间隔。

'Android;12;HUAWEI;ADA-AL00'(需编码,详见下文)

设备信息中的特殊字符必须进行 URL 编码,以确保字段解析的正确性。

2. 字段分隔与编码规则

多字段分隔符

  • 不同字段(iplast_oiddevice)之间用 ; 分隔。

  • 示例: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