环境

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

是

256

商户请求参数的签名串，详见签名（https://docs.open.alipay.com/200/105351）

详见示例

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

详见应用授权概述（https://docs.open.alipay.com/common/105193）

biz_content

String

是

-

请求参数的集合，最大长度不限，除公共参数外所有请求参数都必须放在这个参数中传递，具体参照各产品快速接入文档

参数

中文名称

类型

是否必填

最大长度

描述

示例值

service

服务类型

string

是

128

用户匹配服务类型, 请按照示例值填写

固定传入nsf

process_code

处理结果

string

是

2

标识客户处理的结果类型

固定传11

user_id

用户账号

string

是，user_id和mobile_no至少填一个

128

用于输入用户支付宝的 2088 账号，如不了解此字段如何获取，可了解下静默授权。如参数无法提供，请填写“null”

2088501624560335

mobile_no

用户手机号码

string

是，user_id和mobile_no至少填一个

128

用于输入用户注册支付宝的手机号码。如参数无法提供，请填写“null”

13810935692

risk_label

样本标签

string

是

128

0,1(0代表白样本，1代表黑样本)

0

business

行业

string

是

128

01-无人货柜02-信用回收03-信用租赁04-其它

01

cert_no

身份证号

string

否

256

该账号对应的身份证号

150239198500000000

bank_card_no

银行卡号

string

否

256

该账号对应的银行卡号

421234234234234000

email_address

邮箱地址

string

否

128

该账户注册时填写的邮箱地址

user_name

用户姓名

string

否

128

用户姓名，如无法提供，可填写为空值（null）

李三

lbs

交易地理位置

String

否

128

用于输入用户产生交易时的地理位置信息。如参数无法提供，请填写“null”

120.507796,30.309805

sales_amount

交易金额

String

否

128

用户购买或使用服务时产生的具体金额。如参数无法提供，请填写“null”

97.23

ip

账户登录ip

String

否

128

账户登录IP，如无法提供，可填写为空值（null）

192.168.0.1

imei

手机序列号

String

否

128

手机序列号，如无法提供，可填写为空值（null）

865736031418584

imsi

国际移动用户识别码

String

否

128

国际移动用户识别码，如无法提供，可填写为空值（null）

460001234567890

mac_address

mac地址或设备唯一标识

String

否

128

mac地址或设备唯一标识，如无法提供，可填写为空值（null）

42.118.71.72

reason_label

标签理由

String

否

128

01-   用户投诉

02-   公司判断

03-   除支付宝外第三方平台判断

04-   其它

01

sample_meaning

黑样本含义

String

否

128

01-   逾期

02-   其它"

01

extended_info

String

否

1024

拓展字段，其余信息通过此字段进行传输：

如无法提供，可填写为空值（null）

业务约定：

register_date:账户注册时间

performance_count:履约次数

default_count： 违约次数

average_days_overdue：逾期平均天数

average_money_overdue:逾期平均金额

last_date_overdue:最近一期逾期日期

"extended_info":{"reg_time":"2018-10-01 00:00:09","performance_count":"2","default_count":"1","average_days_overdue":"10","average_days_overdue":"10","last_date_overdue":"2019-02-14"}

参数

中文名称

类型

是否必填

最大长度

描述

示例值

register_date

 用户在平台注册日期

string

否

128

 用户在平台注册日期

performance_count

履约次数

string

否

2

履约次数

default_count

违约次数

string

否

40

违约次数

average_days_overdue

逾期平均天数

string

否

128

逾期平均天数

average_money_overdue

逾期平均金额

string

否

128

逾期平均金额

last_date_overdue

最近一期逾期日期

string

否

128

最近一期逾期日期

参数

中文名称

类型

是否必填

最大长度

描述

示例值

service

服务类型

string

是

128

用户匹配服务类型, 请按照示例值填写

固定传入marketing

process_code

处理结果

string

是

2

标识客户处理的结果类型

固定传11

user_id

用户账号

string

是，user_id和mobile_no至少填一个

128

用于输入用户支付宝的 2088 账号，如不了解此字段如何获取，可了解下静默授权。如参数无法提供，请填写“null”

2088501624560335

mobile_no

用户手机号码

string

是，user_id和mobile_no至少填一个

128

用于输入用户注册支付宝的手机号码。如参数无法提供，请填写“null”

13810935692

risk_label

样本标签

string

是

128

0,1(0代表白样本，1代表黑样本)

0

cert_no

身份证号

string

否

256

该账号对应的身份证号

150239198500000000

bank_card_no

银行卡号

string

否

256

该账号对应的银行卡号

421234234234234000

email_address

邮箱地址

string

否

128

该账户注册时填写的邮箱地址

user_name

用户姓名

string

否

128

用户姓名，如无法提供，可填写为空值（null）

李三

lbs

交易地理位置

String

否

128

用于输入用户产生交易时的地理位置信息。如参数无法提供，请填写“null”

120.507796,30.309805

sales_amount

交易金额

String

否

128

用户购买或使用服务时产生的具体金额。如参数无法提供，请填写“null”

97.23

ip

账户登录ip

String

否

128

账户登录IP，如无法提供，可填写为空值（null）

192.168.0.1

imei

手机序列号

String

否

128

手机序列号，如无法提供，可填写为空值（null）

865736031418584

imsi

国际移动用户识别码

String

否

128

国际移动用户识别码，如无法提供，可填写为空值（null）

460001234567890

mac_address

mac地址或设备唯一标识

String

否

128

mac地址或设备唯一标识，如无法提供，可填写为空值（null）

42.118.71.72

product_name

商品名称

String

否

128

商品名称，如无法提供，可填写为空值（null）或不传此字段

iPhoneX

reason_label

标签理由

String

否

128

01-   用户投诉

02-   公司判断

03-   除支付宝外第三方平台判断

04-   其它

01

sample_meaning

黑样本含义

String

否

128

01-   代表刷单

02-   代表薅羊毛

03-   代表黄牛

04-   低价值

05-   领券

06-   核销券

07-   不复购

08-   其它

03

extended_info

String

否

1024

拓展字段，其余信息通过此字段进行传输：

如无法提供，可填写为空值（null）

业务约定：

register_date:账户注册时间

coupon_discount:优惠券折扣

coupon_money:优惠券金额

coupon_use_condition:优惠券使用门槛（满多少）

"extended_info":{"register_date":"2018-10-01 00:00:09","coupon_discount":"20%","coupon_money":"3","coupon_use_condition":"100"}

参数

中文名称

类型

是否必填

最大长度

描述

示例值

 register_date

 用户在平台注册日期

string

否register_date

128

 用户在平台注册日期

coupon_discount

优惠券折扣

string

否

128

优惠券折扣

coupon_money

优惠券金额

string

否

128

优惠券金额

coupon_use_condition

优惠券使用门槛（满多少）

string

否

128

优惠券使用门槛（满多少）

ship_address

收货地址

string

否

128

收货地址

参数

中文名称

类型

是否必填

最大长度

描述

示例值

service

服务类型

string

是

128

用户匹配服务类型, 请按照示例值填写

固定传indirect_mer_score

process_code

处理结果

string

是

2

标识客户处理的结果类型

固定传11

smid

商户ID

string

是

40

涉嫌风险子商户在支付宝被分配的商户ID

2088256325102154

business_license_no

公司营业执照编号

string

是，business_license_no、bank_card_no和cert_no至少填一个

128

公司营业执照编号，如无法提供，可填写为空值（null） 

8765456787654

bank_card_no

银行卡号

string

是，business_license_no、bank_card_no和cert_no至少填一个

128

该账号对应的银行卡号

421234234234234000

cert_no

身份证号

string

是，business_license_no、bank_card_no和cert_no至少填一个

128

该账号对应的身份证号

150239198500000000

risk_label

样本标签

string

是

128

0,1(0代表白样本，1代表黑样本)

0

mobile_no

用户手机号码

string

否

128

用于输入用户注册支付宝的手机号码。如参数无法提供，请填写“null”

13810935692

company_name

公司名称

string

否

128

公司名称，如无法提供，可填写为空值（null）

测试公司

lbs

交易地理位置

String

否

128

用于输入用户产生交易时的地理位置信息。如参数无法提供，请填写“null”

120.507796,30.309805

ip

账户登录ip

String

否

128

账户登录IP，如无法提供，可填写为空值（null）

192.168.0.1

imei

手机序列号

String

否

128

手机序列号，如无法提供，可填写为空值（null）

865736031418584

imsi

国际移动用户识别码

String

否

128

国际移动用户识别码，如无法提供，可填写为空值（null）

460001234567890

mac_address

mac地址或设备唯一标识

String

否

128

mac地址或设备唯一标识，如无法提供，可填写为空值（null）

42.118.71.72

reason_label

标签理由

String

否

128

01-   用户投诉

02-   公司判断

03-   除支付宝外第三方平台判断

04-   其它

01

sample_meaning

黑样本含义

String

否

128

01-   不提额

02-   逾期

03-   不放贷

04-   其它"

01

extended_info

String

否

1024

拓展字段，其余信息通过此字段进行传输：

如无法提供，可填写为空值（null）

业务约定：

register_date:账户注册时间

merchant_ scael:公司规模（员工数）

business_time:营业时间

poi_count:分店数量

merchant_type:商户类型（门店类或流动类）

"extended_info":{"register_date":"2018-10-01 00:00:09","merchant_ scael":"2000","business_time":"10:00-22:00","poi_count":"50","merchant_type":"流动类"}

参数

中文名称

类型

是否必填

最大长度

描述

示例值

register_date

 用户在平台注册日期

string

否

128

 用户在平台注册日期

merchant_ scael

商户规模（员工数）

String

否

128

商户规模（员工数）

business_time

营业时间

String

否

128

营业时间

【10:00】-【13:00】；【14:00】-【22:00】

poi_count

分店数量

String

否

128

分店数量，

8

merchant_type

商户类型

String

否

128

商户类型

01-   门店类；

02-   流动类；

code

String

是

-

网关返回码（https://docs.open.alipay.com/common/105806）

40004

msg

String

是

-

网关返回码描述（https://docs.open.alipay.com/common/105806）

Business Failed

sub_code

String

否

-

业务返回码（https://docs.open.alipay.com/common/105806）

ACQ.TRADE_HAS_SUCCESS

sub_msg

String

否

-

业务返回码描述

交易已被支付

sign

String

是

-

签名,详见文档（https://docs.open.alipay.com/291/106074）