文档中心 > RiskGo安全合作平台文档

营销反作弊接口文档

更新时间:2019/06/13 访问次数:8150

一、 服务适用场景

账户反作弊服务适用于平台、电商类合作伙伴在进行营销活动时,通过调取 账户反作弊服务接口,来确定参与活动的用户,是否有作弊风险。商家可依据接 口返回的建议,对有作弊风险的用户采取如减少营销资源投放等措施,以此来提 升营销推广效果。

二、参数说明

1、请求入参说明

 过手机号来判断用户的风险程度,其他信息如果一起提供,将有效提升风险识别的准确性,如果不提供具体信息,请传空值(“”),详细参数说明见参数示例。

2、返回参数说明

rank0 信息不足或提供的参数有误

rank1 表示用户作弊风险为低或者无风险

rank2 表示用户作弊风险为中

rank3 表示用户作弊风险为高

三、完整请求参数说明

环境

HTTPS 请求地址

正式环境

https://openapi.alipay.com/gateway.do

公共请求参数(sdk已封装)

参数 

类型 

是否必填

最大长度  

描述

示例值

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\ "

 

五、代码样例 

1、调用样例:

{"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"}}

2、代码返回值样例

{"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=="}

 

FAQ

关于此文档暂时还没有FAQ
返回
顶部