API列表

此文档,面向技术人员提供,用于进行接口联调时参考所用

一. 推送接口:用于接收支付宝推送的风险交易

1.接口名: alipay.adatabus.risk.end.push

2.请求地址:

环境 商户网关地址
正式环境 接收风险交易推送的地址
请求方式 POST

推送风险内容:
   我们会依据您申请服务的PID/支付宝账号进行风险交易的推送。 
    请在收到推送通知并且验签通过后,返回支付宝 success 七个字符。

3.参数说明

(1)公共返回参数

参数 类型 是否必填 最大长度 参数描述 示例值
service String 128 服务出口网关名 alipay.adatabus.risk.end.push
sign_type String 10 签名方式(RSA或RSA2) RSA2
sign String 1024 签名值
charset String 10 请求的编码格式,返回的响应 GBK

(2)业务参数(我们会依据您开展的业务类型,向您推送不同的内容)

银行角色:

参数 类型 是否必填 最大长度 参数描述 示例值
smid String 40 涉嫌风险子商户在支付宝被分配的商户ID 2088256325102154
pid String 40 申请业务合作伙伴ID 2088765523456679
externalId String 40 涉嫌风险子商户在银行被分配的商户ID 101530278966
sourceId String 40 风险子商户对应的服务商ID 2088121907460882
tradeNos String 40 风险交易号样例(由于风险识别策略差异,个别情况,无风险交易号样例) 201705090000000001wd2
risktype String 40 风险类型 欺诈、赌博、套现、套费率
risklevel String 40 风险情况描述 欺诈风险(欺诈风险极高,且有投诉)
riskDesc String 1024 风险定位原因说明 套费率:例如:买卖家关系异常

服务商角色

间连业务场景

参数 类型 是否必填 最大长度 参数描述 示例值
smid String 40 涉嫌风险子商户在支付宝被分配的商户ID 2088256325102154
pid String 40 申请业务合作伙伴ID 2088123407460882
externalId String 40 涉嫌风险子商户在银行被分配的商户ID 101530278966
sourceId String 40 风险子商户对应的服务商ID 2088121907460882
tradeNos String 40 风险交易号样例(由于风险识别策略差异,个别情况,由于无风险交易号样例) 201705090000000001wd2
risktype String 40 风险类型 欺诈、赌博、套现、套费率
risklevel String 40 风险情况描述 欺诈风险(欺诈风险极高,且有投诉)
riskDesc String 1024 风险定位原因说明 套费率:例如:买卖家关系异常

直连业务场景

参数
类型
是否必填
最大长度
参数描述
示例值
pid
String
40
申请业务合作伙伴ID
2088123407460882
merchantId
String
40
涉嫌风险商户的PID
虚假交易场景下此字段代表有风险的服务商服务商小二的账户ID
2088765523456679
tradeNos
String
40
风险交易号样例(由于风险识别策略差异,个别情况,无风险交易号样例)
201705090000000001wd2
risktype
String
40
风险类型
虚假交易
risklevel
String
40
风险情况描述
欺诈、赌博、套现、虚假交易
riskDesc
String
1024
风险定位原因说明
商户整体虚假交易原因:
交易相关方具有关联关系且交易背景不真实
虚假交易金额(分):100.0;
虚假交易占比:1.0;
本笔交易虚假交易原因:
交易相关方具有关联关系且交易背景不真实
近一周作业商家数:32;
风险商家数:2;
总交易笔数:275;
风险交易笔数:67;
风险类型:套费率:
例如:买卖家关系异常

商户角色

参数 类型 是否必填 最大长度 参数描述 示例值
pid String 40 申请业务合作伙伴ID 2088765523456679
tradeNos String 40 风险交易号样例(个别情况,由于无风险交易号样例) 201705090000000001wd2
risktype String 40 风险类型 欺诈、赌博、套现、投诉
risklevel String 40 风险情况描述 欺诈风险(欺诈风险极高,且有投诉)
complainTime String 128 用户投诉时间 2018/8/19 23:40
complainText String 256 用户投诉内容 付款成功后,没有开通会员

二. 同步接口:用于向支付宝返回针对风险交易的处理方式

1.接口名: alipay.security.risk.customerrisk.send

2.请求地址:

环境 HTTPS请求地址
正式环境 https://openapi.alipay.com/gateway.do

公共请求参数:

参数 类型 是否必填 最大长度 描述 示例值
app_id String 32 支付宝分配给开发者的应用ID 2014072300007148
method String 128 接口名称 alipay.security.risk.customerrisk.send
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 商户请求参数的签名串,详见签名 详见示例
timestamp String 19 发送请求的时间,格式"yyyy-MM-dd HH:mm:ss" 2014-07-24 03:07:50
version String 3 调用的接口版本,固定为:1.0 1.0
notify_url String 256 支付宝服务器主动通知商户服务器里指定的页面http/https路径。 http://api.test.alipay.net/atinterface/receive_notify.htm
app_auth_token String 40 详见应用授权概述
biz_content String - 请求参数的集合,最大长度不限,除公共参数外所有请求参数都必须放在这个参数中传递,具体参照各产品快速接入文档

业务请求参数:

参数
中文名称
类型
是否必回传项
最大长度
描述
示例值
plat_account
平台账号
string
1024
指第三方在商户平台注册成功后,平台给予的账户号
trade_no
交易号
string
1024
支付宝推送的风险消息中的交易号
2017113021001004640000000000
pid
合作者身份ID
string
256
填写与trade_no对应的pid。2088开头的16位数字
2088123456789012
bank_card_no
银行卡号
string
256
该账号对应的银行卡号
421234234234234000
cert_no
身份证号
string
256
该账号对应的身份证号
150239198500000000
business_license_no
营业执照号
string
1024
该账号对应的营业执照号
34xggdf345
mobile
手机号
string
18
该账号对应的手机号
18667000000
mobile_ip
手机号IP
string
1024
该账号对应的手机号的IP
10.253.231.22
order_ip
下单IP
string
1024
该账户在商户平台下单时的MAC地址或IP地址
00000000-01010000-10111010
merch_name
商品名称
string
1024
该笔风险交易购买的具体商品名称
xx商品
email_address
邮箱地址
string
1024
该账户注册时填写的邮箱地址
 
process_code
处理结果
string
2
商户对该账户采取的措施。
多种处理结果可调用多次,每次回传一种处理结果。(01:暂停发货;02:延迟结算;03:关停账户;04:暂停发货+关停账户;05:延迟结算+关停账户;06:其他;07:平台进行退款退订;08:平台跟用户沟通后,用户撤诉;09:未进行处理。)
01

响应参数:

参数 类型 是否必填 最大长度 描述 示例值
code String - 网关返回码 40004
msg String - 网关返回码描述 Business Failed
sub_code String - 业务返回码 ACQ.TRADE_HAS_SUCCESS
sub_msg String - 业务返回码描述 交易已被支付
sign String - 签名,详见文档

错误码: 

错误码
返回样例
原因
MISSING_REQUIRED_ARGUMENTS
{success=false, result=null, errorCode='MISSING_REQUIRED_ARGUMENTS', errorMessage='缺少必选参数'}
smid或process_code为空
INVALID_PARAMETER
{success=false, result=null, errorCode='INVALID_PARAMETER', errorMessage='参数不合法'}
process_code不是两位数字
正确返回样例
{success=true, result={"success":"true"}, errorCode='null', errorMessage='null'}
onlineServer