芝麻信用企业信用评分
快速接入
第一步：创建应用
要在您的应用中使用支付宝开放产品的接口能力，您需要先去蚂蚁金服开放平台（
open.alipay.com
），在开发者中心中创建登记您的应用，并提交审核，审核通过后会为您生成应用唯一标识（APPID），并且可以申请开通开放产品使用权限，通过APPID您的应用才能调用开放产品的接口能力。需要详细了解开放平台创建应用步骤请参考《
开放平台应用创建指南》。
第二步：配置密钥
开发者调用接口前需要先生成RSA密钥，RSA密钥包含应用私钥(APP_PRIVATE_KEY)、应用公钥(APP_PUBLIC_KEY）。生成密钥后在开放平台开发者中心进行密钥配置，配置完成后可以获取支付宝公钥(ALIPAY_PUBLIC_KEY)。详情请参考《
配置应用环境》。
第三步：搭建和配置开发环境
1.下载服务端SDK
为了帮助开发者调用开放接口，我们提供了
开放平台服务端SDK，包含JAVA、PHP和.NET三个语言版本，封装了签名&验签、HTTP接口请求等基础功能。请先下载对应语言版本的SDK并引入您的开发工程。 各语言版本服务端SDK详细使用说明，请参考《
服务端SDK使用说明》
2.接口调用配置
在SDK调用前需要进行初始化，代码如下：
AlipayClient alipayClient = new DefaultAlipayClient(URL, APP_ID, APP_PRIVATE_KEY, FORMAT, CHARSET, ALIPAY_PUBLIC_KEY, SIGN_TYPE);
关键参数说明:
|
配置参数
|
示例值解释
|
获取方式/示例值
|
|
URL
|
支付宝网关（固定）
|
|
|
APPID
|
APPID 即创建应用后生成
|
获取见上面
创建应用并获取APPID
|
|
APP_PRIVATE_KEY
|
开发者私钥，由开发者自己生成
|
获取详见上面
配置密钥
|
|
FORMAT
|
参数返回格式，只支持json
|
json（固定）
|
|
CHARSET
|
编码集，支持GBK/UTF-8
|
开发者根据实际工程编码配置
|
|
ALIPAY_PUBLIC_KEY
|
支付宝公钥，由支付宝生成
|
获取详见上面
配置密钥
|
|
SIGN_TYPE
|
商户生成签名字符串所使用的签名算法类型，目前支持RSA2和RSA，推荐使用RSA2
|
RSA2
|
**TIPS：**ISV/开发者可以通过“第三方应用授权”得到商户授权令牌（app_auth_token）作为请求参数传入，实现代商户发起请求的能力；具体方法请参考
第三方应用授权。
第四步：接口调用
接入流程：
-
使用芝麻信用企业信用评分前需要获得用户的授权，具体的授权方式请参见《授权说明》目录。
-
授权以后，可以获得该用户的access_token， 使用该access_token可进行芝麻信用企业信用评分的查询。
接口调用示例：
AlipayClient alipayClient = new DefaultAlipayClient("https://openapi.alipay.com/gateway.do","app_id","your private_key","json","GBK","alipay_public_key","RSA2");
ZhimaCreditEpScoreGetRequest request = new ZhimaCreditEpScoreGetRequest();
request.setBizContent("{" +
"\"transaction_id\":\"201512100936588040000000465158\"," +
"\"product_code\":\"w1010100003000001418\"" +
" }");
ZhimaCreditEpScoreGetResponse response = alipayClient.execute(request,accessToken);
if(response.isSuccess()){
System.out.println("调用成功");
} else {
System.out.println("调用失败");
}
|
TIPS：1、调用该接口之前需经过芝麻用户授权，否则会返回鉴权失败；2、在用户无法评分时，zm_score返回字符串N/A。
|
关于沙箱
如何接入沙箱
沙箱环境是开放平台提供给开发者调试接口的环境，具体操作步骤见
沙箱接入指南。
芝麻信用企业信用评分沙箱接入注意点
1、芝麻信用企业信用评分支持沙箱接入；在沙箱调通接口后，必须在线上进行测试与验收，所有返回码及业务逻辑以线上为准； 2、芝麻信用企业信用评分请使用芝麻信用产品沙箱工具测试：点击开发者中心-沙箱环境-
沙箱工具。
