开发者社区
社区提问意见反馈
开发者钉组织
扫描二维码
加入支付宝开发者钉组织
支付产品
私域产品
公域产品
营销产品
资金产品
会员产品
信用产品
芝麻 go
芝麻先享
接入指南
api 列表
服务开通
信用下单
扣款
相关资料
芝麻免押
安全产品
广告产品
开发 > 服务端 >  >  >  >  > 信用服务开通/授权接口
收藏
订阅更新
我的文档
设置

接口说明

该接口是 签名数据准备接口,用于生成可信签名字符串(orderstr)。可信签名串中包含业务参数及商户身份信息,可防止数据被篡改,一般用于打开支付宝客户端。请在服务端执行支付宝sdk中sdkexecute方法,读取响应中的body()结果。具体使用方法请参考
信用服务开通/授权

公共请求参数

参数类型是否必选最大长度描述示例值
app_idstring必选32
支付宝分配给开发者的应用id
2014072300007148
methodstring必选128
接口名称
zhima.credit.payafteruse.creditagreement.sign
formatstring可选40
仅支持json
json
charsetstring必选10
请求使用的编码格式,如utf-8,gbk,gb2312等
utf-8
sign_typestring必选10
商户生成签名字符串所使用的签名算法类型,目前支持rsa2和rsa,推荐使用rsa2
rsa2
signstring必选344
商户请求参数的签名串,详见签名
详见示例
timestampstring必选19
发送请求的时间,格式"yyyy-mm-dd hh:mm:ss"
2014-07-24 03:07:50
versionstring必选3
调用的接口版本,固定为:1.0
1.0
app_auth_tokenstring可选40
biz_contentstring必选
请求参数的集合,最大长度不限,除公共参数外所有请求参数都必须放在这个参数中传递,具体参照各产品快速接入文档

业务请求参数

out_agreement_no必选string(64)
【描述】商户外部协议号,不同的支付宝用户需要传递不同的外部单号
【示例值】2014070700166653
zm_service_id必选string(64)
【描述】芝麻信用服务id
【示例值】2020050722001440031000061082
category_id可选string(64)
【描述】芝麻外部类目,先享产品无差异化诉求可不传
【示例值】credit_pay_after_use
cancel_back_link可选string(1024)
【描述】当用户进入信用服务开通/授权页面后,点击左上角的回退按钮,中断开通流程,跳转回商户的页面地址。支持scheme协议。不传该链接时,默认返回上一级页面,由外部app唤起支付宝的情况,会返回支付宝凯发k8官方网娱乐官方首页。
【示例值】https://www.taobao.com
return_back_link可选string(1024)
【描述】用户信用服务开通流程结束后,不区分用户开通成功/失败,跳转回商家页面,该字段代表跳转回商家的页面地址。支持scheme协议。不传该链接时,默认返回上一级页面,由外部app唤起支付宝的情况,会返回支付宝凯发k8官方网娱乐官方首页。
【示例值】https://www.taobao.com
extra_param可选string(1024)
【描述】业务扩展参数,用于商户的特定业务信息的传递,json格式。无特殊需求时,不需要传递该参数。
【示例值】{"merchantext":"key=value"}
常见请求示例
package com.java.sdk.demo;
import com.alipay.api.alipayapiexception;
import com.alipay.api.alipayclient;
import com.alipay.api.defaultalipayclient;
import com.alipay.api.alipayconfig;
import com.alipay.api.domain.zhimacreditpayafterusecreditagreementsignmodel;
import com.alipay.api.request.zhimacreditpayafterusecreditagreementsignrequest;
import com.alipay.api.response.zhimacreditpayafterusecreditagreementsignresponse;
import com.alipay.api.fileitem;
import java.util.base64;
import java.util.arraylist;
import java.util.list;
public class zhimacreditpayafterusecreditagreementsign {
    public static void main(string[] args) throws alipayapiexception {
        // 初始化sdk
        alipayclient alipayclient = new defaultalipayclient(getalipayconfig());
        // 构造请求参数以调用接口
        zhimacreditpayafterusecreditagreementsignrequest request = new zhimacreditpayafterusecreditagreementsignrequest();
        zhimacreditpayafterusecreditagreementsignmodel model = new zhimacreditpayafterusecreditagreementsignmodel();
        
        // 设置芝麻信用服务id
        model.setzmserviceid("2020050722001440031000061082");
        
        // 设置芝麻外部类目
        model.setcategoryid("credit_pay_after_use");
        
        // 设置当用户进入信用服务开通/授权页面后
        model.setcancelbacklink("https://www.taobao.com");
        
        // 设置用户信用服务开通流程结束后
        model.setreturnbacklink("https://www.taobao.com");
        
        // 设置业务扩展参数
        model.setextraparam("{\"merchantext\":\"key=value\"}");
        
        // 设置商户外部协议号
        model.setoutagreementno("2014070700166653");
        
        request.setbizmodel(model);
        // 第三方代调用模式下请设置app_auth_token
        // request.putothertextparam("app_auth_token", "<-- 请填写应用授权令牌 -->");
        zhimacreditpayafterusecreditagreementsignresponse response = alipayclient.sdkexecute(request);
        string orderstr = response.getbody();
        system.out.println(orderstr);
        if (response.issuccess()) {
            system.out.println("调用成功");
        } else {
            system.out.println("调用失败");
            // sdk版本是"4.38.0.all"及以上,可以参考下面的示例获取诊断链接
            // string diagnosisurl = diagnosisutils.getdiagnosis;
            // system.out.println(diagnosisurl);
        }
    }
    private static alipayconfig getalipayconfig() {
        string privatekey  = "<-- 请填写您的应用私钥,例如:miievqibadanb ... ... -->";
        string alipaypublickey = "<-- 请填写您的支付宝公钥,例如:miibijanbg... -->";
        alipayconfig alipayconfig = new alipayconfig();
        alipayconfig.setserverurl("https://openapi.alipay.com/gateway.do");
        alipayconfig.setappid("<-- 请填写您的appid,例如:2019091767145019 -->");
        alipayconfig.setprivatekey(privatekey);
        alipayconfig.setformat("json");
        alipayconfig.setalipaypublickey(alipaypublickey);
        alipayconfig.setcharset("utf-8");
        alipayconfig.setsigntype("rsa2");
        return alipayconfig;
    }
}
说明:本示例仅供参考。

公共响应参数

无公共响应参数

业务响应参数

orderstr|签名字符串必选string(16384)
【描述】获取签名后的业务数据具体使用方法请参考
【示例值】请参考响应示例
响应示例
app_id=2017060101317939&biz_content={"zm_service_id%22:%222020050722001440031000061082%22,"category_id%22:"credit_pay_after_use%22,"cancel_back_link%22:"https://www.taobao.com%22,"return_back_link%22:"https://www.taobao.com%22,"extra_param%22:%22{\"merchantext\%22:\"key=value\%22}%22,"out_agreement_no%22:%222014070700166653%22}&charset=utf-8&format=json&method=zhima.credit.payafteruse.creditagreement.sign&sign=eritjkeijkjhkkkkkkkhjereeeeeeeeeee&sign_type=rsa2×tamp=2014-07-24 03:07:50&version=1.0
说明:本示例仅供参考。

公共错误码

业务错误码

无业务错误码

内容没有解决您的问题?您还可以前往 或 寻求帮助
凯发k8官方网娱乐官方 copyright © 支付宝(杭州)信息技术有限公司  | icp证浙b2-20160559
该文档对你是否有帮助?
当前页面目录
为开发者能享受更简单的协议处理逻辑、更丰富的开源工具配套、更低的接口响应时延,支付宝开放平台推出符合oas3.0规范的,助力开发体验。新版本文档请点击“查看v3版本”进行访问。
网站地图