淘宝开放平台

请求地址：

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

公共请求参数：

参数	类型	是否必填	最大长度	描述	示例值
app_id	String	是	32	支付宝分配给开发者的应用ID	2014072300007148
method	String	是	128	接口名称	zhima.credit.antifraud.score.get
format	String	否	40	仅支持JSON	JSON
charset	String	是	10	请求使用的编码格式，如utf-8,gbk,gb2312等	utf-8
sign_type	String	是	10	商户生成签名字符串所使用的签名算法类型，目前支持RSA2和RSA，推荐使用RSA2	RSA2
sign	String	是	256	商户请求参数的签名串，详见签名	详见示例
timestamp	String	是	19	发送请求的时间，格式"yyyy-MM-dd HH:mm:ss"	2014-07-24 03:07:50
version	String	是	3	调用的接口版本，固定为：1.0	1.0
app_auth_token	String	否	40	详见应用授权概述
biz_content	String	是	-	请求参数的集合，最大长度不限，除公共参数外所有请求参数都必须放在这个参数中传递，具体参照各产品快速接入文档

参数	类型	是否必填	最大长度	描述	示例值
product_code	String	必须	32	产品码，标记商户接入的具体产品；直接使用每个接口入参中示例值即可	w1010100003000001100
transaction_id	String	必须	64	商户请求的唯一标志，长度64位以内字符串，仅限字母数字下划线组合。该标识作为业务调用的唯一标识，商户要保证其业务唯一性，使用相同transaction_id的查询，芝麻在一段时间内（一般为1天）返回首次查询结果，超过有效期的查询即为无效并返回异常，有效期内的重复查询不重新计费	20151127233347987676212309253
cert_no	String	必须	64	证件号码	640202199007164686
cert_type	String	必须	32	证件类型。IDENTITY_CARD标识为身份证，目前仅支持身份证类型	IDENTITY_CARD
name	String	必须	64	姓名，长度不超过64，姓名中不含",","/u0001"，"\|","&","^","\\"	牛德华
mobile	String	可选	20	手机号码。中国大陆合法手机号，长度11位，不含国家代码	15843991158
email	String	可选	64	电子邮箱。合法email，字母小写，特殊符号以半角形式出现	jnlxhy@alitest.com
bank_card	String	可选	64	银行卡号。中国大陆银行发布的银行卡:借记卡长度19位；信用卡长度16位；各位的取值位[0,9]的整数；不含虚拟卡	20110602436748024138
address	String	可选	256	地址信息。省+市+区/县+详细地址，长度不超过256，不含",","/u0001"，"\|","&","^","\\"	北京北京市朝阳区呼家楼街道北京市朝阳区东三环中路1号环球金融中心东塔9层
ip	String	可选	20	ip地址。以"."分割的四段Ip，如 x.x.x.x，x为[0,255]之间的整数	101.247.161.1
mac	String	可选	20	物理地址。支持格式如下：xx:xx:xx:xx:xx:xx，xx-xx-xx-xx-xx-xx，xxxxxxxxxxxx，x取值范围[0,9]之间的整数及A，B，C，D，E，F	AA-34-4D-59-61-28
wifimac	String	可选	20	wifi的物理地址。支持格式如下：xx:xx:xx:xx:xx:xx，xx-xx-xx-xx-xx-xx，xxxxxxxxxxxx，x取值范围[0,9]之间的整数及A，B，C，D，E，F	22-35-4A-5F-07-88
imei	String	可选	15	国际移动设备标志。15位长度数字	868331011992179

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

参数	类型	是否必填	最大长度	描述	示例值
biz_no	String	必填	32	芝麻信用对于每一次请求返回的业务号。后续可以通过此业务号进行对账	ZM201608223000000242400084180839
score	Number	必填	5	申请欺诈评分，分数范围是[0,100]的整数,分数越高信息越真实	95
solution_id	String	选填	255	方案ID，可空，产品定制使用。在线可能会存在多个方案并行，方案ID标识当前请求使用的在线方案	ANTIFRAUD_20171003010000000061
decision_result	String	选填	12	决策结果，可空，取值当前为REJECT\REVIEW\PASS，产品定制使用。根据产品定制配置，对结果进行决策返回	PASS

JAVA
.NET
PHP
HTTP请求源码

1

2

3

4

5

6

7

8

9

10

11

12

13

14

15

16

17

18

19

20

21

22

23

AlipayClient alipayClient = new DefaultAlipayClient("https://openapi.alipay.com/gateway.do","app_id","your private_key","json","GBK","alipay_public_key","RSA2");
ZhimaCreditAntifraudScoreGetRequest request = new ZhimaCreditAntifraudScoreGetRequest();
request.setBizContent("{" +
"\"product_code\":\"w1010100003000001100\"," +
"\"transaction_id\":\"20151127233347987676212309253\"," +
"\"cert_no\":\"640202199007164686\"," +
"\"cert_type\":\"IDENTITY_CARD\"," +
"\"name\":\"牛德华\"," +
"\"mobile\":\"15843991158\"," +
"\"email\":\"jnlxhy@alitest.com\"," +
"\"bank_card\":\"20110602436748024138\"," +
"\"address\":\"北京北京市朝阳区呼家楼街道北京市朝阳区东三环中路1号环球金融中心东塔9层\"," +
"\"ip\":\"101.247.161.1\"," +
"\"mac\":\"AA-34-4D-59-61-28\"," +
"\"wifimac\":\"22-35-4A-5F-07-88\"," +
"\"imei\":\"868331011992179\"" +
"}");
ZhimaCreditAntifraudScoreGetResponse response = alipayClient.execute(request);
if(response.isSuccess()){
System.out.println("调用成功");
} else {
System.out.println("调用失败");
}

JSON示例

{
    "zhima_credit_antifraud_score_get_response":{
        "msg":"Success",
        "score":95,
        "code":"10000",
        "decision_result":"PASS",
        "biz_no":"ZM201608223000000242400084180839",
        "solution_id":"ANTIFRAUD_20171003010000000061"
    },
    "sign":"ERITJKEIJKJHKKKKKKKHJEREEEEEEEEEEE"
}

JSON示例

{
    "zhima_credit_antifraud_score_get_response":{
        "msg":"Service Currently Unavailable",
        "code":"20000",
        "sub_msg":"系统繁忙",
        "sub_code":"isp.unknow-error"
    },
    "sign":"ERITJKEIJKJHKKKKKKKHJEREEEEEEEEEEE"
}

错误码	错误描述	解决方案
API_PRODUCT_NOT_MATCH	输入的产品码不正确	按照接口文档传入正确的产品码
INVALID_TRANSACTION_ID	业务流水号不正确	传入transaction_id字段,支持字母、数字、下划线
NO_VALID_ARRANGEMENT	无有效合约	完成产品签约
INVALID_PARAMETER	参数有误	修改合法的接口参数
PRODUCT_CODE_IS_NULL	产品码为空	请输入产品码
SYSTEM_ERROR	系统繁忙	重试或反馈芝麻信用技术支持
TRANSACTION_ID_EXPIRED	业务流水号已过期	请传入正确的业务流水号
TRANSACTION_ID_REPEAT	相同业务流水号但业务参数不一致，无法提供服务	每个请求请生成唯一的业务流水号transaction_id
THIRD_PARTY_API_INVALID	第三方系统异常	稍后重试或反馈芝麻信用技术支持

公共错误码

芝麻信用API

zhima.credit.antifraud.score.get (申请欺诈评分)

公共参数

请求参数

公共响应参数

响应参数

请求示例

响应示例

异常示例

业务错误码

公共错误码