感谢您的反馈!
账户反作弊服务适用于平台、电商类合作伙伴在进行营销活动时,通过调取 账户反作弊服务接口,来确定参与活动的用户,是否有作弊风险。商家可依据接 口返回的建议,对有作弊风险的用户采取如减少营销资源投放等措施,以此来提 升营销推广效果。
rank0 信息不足或提供的参数有误
rank1 表示用户作弊风险为低或者无风险
rank2 表示用户作弊风险为中
rank3 表示用户作弊风险为高
环境 |
HTTPS 请求地址 |
正式环境 |
https://openapi.alipay.com/gateway.do |
参数 |
类型 |
是否必填 |
最大长度 |
描述 |
示例值 |
app_id |
String |
是 |
32 |
支付宝分配给开发者的应用 ID |
2014072300007148
|
method |
String |
是 |
128 |
接口名称 |
alipay.security.risk.
customerrisk.query
|
format |
String |
否 |
40 |
仅支持 JSON |
JSON |
charset |
String |
是 |
10 |
请求使用的编码格 式,如utf-8,gbk, gb2312 等 |
utf-8 |
sign_type |
String |
是 |
10 |
商户生成签名字符 串所使用的签名算 法类型, 目前支持 RSA/RSA2。推荐使 用 RSA2 |
RSA2 |
sign |
String |
是 |
1024 |
商户请求参数的签 名串, 详见(http s://docs.open.al ipay.com/200/105 351) |
详见示例 |
timestamp |
String |
是 |
19 |
发送请求的时间, 格式"yyyy-MM-dd HH:mm:ss" |
2014-07-24 03:0 7:50
|
version |
String |
是 |
3 |
调用的接口版本 |
1.0 |
参数 |
类型 |
是否必填 |
最大长度 |
描述 |
示例值 |
service |
String |
是 |
128 |
用户匹配服务类型, 请按照示例值填写 |
固定传marketing |
risk_type |
String |
是 |
1024 |
用于代表风险场景类型, 请根据实际场景示例值填写。 |
固定传riskinfo_anticheat_common |
pid |
String |
是 |
128 |
申请业务合作伙伴ID |
2088501624560098 |
user_id |
String |
否 |
128 |
用于输入用户的支付宝 2088 账号,如不了解此字段如何获取,可了解下静默授权,如已知,请直接填写。 |
2088501624560335
|
mobile_no |
String |
是 |
128 |
用于输入用户注册支付宝的手机号码。
|
13810935692 |
cert_no |
String |
否 |
128 |
用于输入用户的身份证 号码。如无法提供,可填写为空值(null) |
230109201112093424 |
bank_card_no |
String |
否 |
128 |
银行卡号,如无法提供,可填写为空值(null) |
|
ip | String | 否 | 128 | 账户登录IP,如无法提供,可填写为空值(null) | 192.168.0.1 |
email_address | String | 否 | 128 | 邮箱账号,如无法提供,可填写为空值(null) | zhifubao@163.com |
imei | String | 否 | 128 | 手机序列号,如无法提供,可填写为空值(null) | 865736031418584 |
imsi | String | 否 | 128 | 国际移动用户识别码,如无法提供,可填写为空值(null) | 460001234567890 |
mac_address | String | 否 | 128 | mac地址或设备唯一标识,如无法提供,可填写为空值(null) | 42.118.71.72 |
extended_info | String | 否 | 2048 | 拓展字段,其余信息通过此字段进行传输: 如无法提供,可填写为空值(null) 业务约定: nickname:账户昵称; reg_time:账户注册时间 |
"extended_info ": { " nickname ": "小蚂蚁", " reg_time ": "2018-10-01 00:00:09" } |
参数 |
类型 |
是否必填 |
最大长度 |
描述 |
示例值 |
code |
String |
是 |
128 |
40004 |
|
msg |
String |
是 |
1024 |
网关返回码描述 |
Business Failed
|
sub_code |
String |
否 |
128 |
业务返回码 |
ACQ.TRADE_HAS_SUCC ESS
|
sub_msg |
String |
否 |
128 |
业务返回码描述 |
交易已被支付 |
sign |
String |
是 |
128 |
支付宝将返回内容做的签名 |
30.27277072 48263
|
参数 |
类型 |
是否必填 |
最大长度 |
描述 |
示例值 |
risk_result |
String |
是 |
128 |
风险分析结果,返回针对用户作弊场景下返回的风险值
|
"riskinfo_anticheat_common":"rank0"}
|
risk_result_desc
|
String |
是 |
1024 |
风险结果分析返回值 rank0 信息不足或提供的参数有误 rank1 表示用户作弊风险为低或者无风险 rank2 表示用户作弊风险为中 rank3 表示用户作弊风险为高 |
\"rank0\":\"等级 0\ " |
{"biz_content":{"service":"marketing","risk_type":"riskinfo_anticheat_common","pid":"2088031872450000","mobile_no":"18511897888","user_id":"20889883883838388","bank_card_no":"null","ip":"null","email_address":"null","imei":"null","imsi":"null","mac_address":"null","extended_info":"null"}}
{"alipay_security_risk_customerrisk_query_response":{"code":"10000","msg":"Success","risk_result_desc":"{\"rank0\":\"等级0\"}","risk_result":"{\"riskinfo_anticheat_common\":\"rank0\"}"},"sign":"h71FSnG9zh567VmEGGs4W3Heip8RJ0B1OHyQyWbK1IQ/xb/gEn35VP2Twm/CONPrZ9PNZC/TR3lLe8y3rbaaYP9zmN+jkzacarVvlNUcaB3HnhmWR7uPs/Pa4GYqphGCq49v2dDhd0tGbNGN43jxE3h5WQhMG0j9lt48gbB7iwksmkhIuQZn8ctzcs17VZVA=="}