淘宝开放平台

请求地址：

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

公共请求参数：

参数	类型	是否必填	最大长度	描述	示例值
app_id	String	是	32	支付宝分配给开发者的应用ID	2014072300007148
method	String	是	128	接口名称	alipay.open.agent.zhimabrief.sign
format	String	否	40	仅支持JSON	JSON
charset	String	是	10	请求使用的编码格式，如utf-8,gbk,gb2312等	utf-8
sign_type	String	是	10	商户生成签名字符串所使用的签名算法类型，目前支持RSA2和RSA，推荐使用RSA2	RSA2
sign	String	是	344	商户请求参数的签名串，详见签名	详见示例
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	详见应用授权概述

参数	类型	是否必填	最大长度	描述	示例值
batch_no	String	必须	25	代商户操作事务编号，通过alipay.open.isv.agent.create接口进行创建。	2017110616474516400082883
mcc_code	String	必须	16	所属MCCCode，详情可参考商家经营类目中的“经营类目编码”	A_A03_4582
special_license_pic	byte[]	特殊可选	5242880	企业特殊资质图片，可参考商家经营类目中的“需要的特殊资质证书”，最小50KB，图片格式必须为：png、bmp、gif、jpg、jpeg	-
business_license_no	String	必须	32	营业执照号码。	8765445678912903
business_license_pic	byte[]	必须	5242880	营业执照图片，最小50KB，图片格式必须为：png、bmp、gif、jpg、jpeg	-
business_license_auth_pic	byte[]	可选	5242880	营业执照授权函图片，个体工商户如果使用总公司或其他公司的营业执照认证需上传该授权函图片，最小50KB，图片格式必须为：png、bmp、gif、jpg、jpeg	-
long_term	Boolean	可选	1	营业期限是否长期有效	true
date_limitation	String	可选	10	营业期限	2017-11-11
enterprise_logo	byte[]	可选	5242880	企业LOGO-图片，最小50KB，图片格式必须为：png、bmp、gif、jpg、jpeg	-
enterprise_alias	String	必须	64	例如：浙江飞猪网络技术有限公司，企业别称请填写【飞猪】。	飞猪
usage_scene	String []	特殊可选	128	使用场景描述，签约芝麻信用产品的用途，可选值："现金放贷","其他", "消费分期（例如买房、装修等）", "融资租赁", "发放信用卡", "极速返利", "押金减免", "先用后付", "社交场景信用互查", "会员分层信用参考"	现金放贷,押金减免
custom_usage_scene	String	特殊可选	128	自定义使用场景描述，usage_scene选项中无符合描述，填写自定义使用场景描述(usage_scene不填写，则custom_usage_scene必填)	优惠返利
dr_contact	ContactModel	必须	64	数据反馈接口人
└ contact_name String 必填 64 联系人名称张三 └ contact_mobile String 必填 16 联系人手机号码 18866668888 └ contact_email String 必填 64 联系人邮箱 zhangsan@alipy.com
oh_contact	ContactModel	必须	64	异议处理接口人
└ contact_name String 必填 64 联系人名称张三 └ contact_mobile String 必填 16 联系人手机号码 18866668888 └ contact_email String 必填 64 联系人邮箱 zhangsan@alipy.com
pr_contact	ContactModel	必须	64	用户服务联动机制接口人
└ contact_name String 必填 64 联系人名称张三 └ contact_mobile String 必填 16 联系人手机号码 18866668888 └ contact_email String 必填 64 联系人邮箱 zhangsan@alipy.com
app_name	String	特殊可选	32	商户的APP应用名称（1 app_name、app_demo；2 web_sites；3 alipay_life_name；4 wechat_official_account_name。1、2、3、4至少选择一个填写）	应用名称
app_demo	byte[]	特殊可选	5242880	APP demo，格式为.apk；或者应用说明文档, 格式为.doc .docx .pdf格式（1 app_name、app_demo；2 web_sites；3 alipay_life_name；4 wechat_official_account_name。1、2、3、4至少选择一个填写）	-
web_sites	String []	特殊可选	256	接入网址信息（1 app_name、app_demo；2 web_sites；3 alipay_life_name；4 wechat_official_account_name。1、2、3、4至少选择一个填写）	www.web.com
alipay_life_name	String	特殊可选	128	支付宝生活号(原服务窗)名称（1 app_name、app_demo；2 web_sites；3 alipay_life_name；4 wechat_official_account_name。1、2、3、4至少选择一个填写）	杭州XX报社
wechat_official_account_name	String	特殊可选	128	微信公众号名称（1 app_name、app_demo；2 web_sites；3 alipay_life_name；4 wechat_official_account_name。1、2、3、4至少选择一个填写）	杭州XX报社

参数	类型	是否必填	最大长度	描述	示例值
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=

参数	类型	是否必填	最大长度	描述	示例值

JAVA
.NET
PHP
HTTP请求源码

AlipayClient alipayClient = new DefaultAlipayClient("https://openapi.alipay.com/gateway.do","app_id","your private_key","json","GBK","alipay_public_key","RSA2");
AlipayOpenAgentZhimabriefSignRequest request = new AlipayOpenAgentZhimabriefSignRequest();
request.setBatchNo("2017110616474516400082883");
request.setMccCode("A_A03_4582");
FileItem SpecialLicensePic = new FileItem(C:/Downloads/ooopic_963991_7eea1f5426105f9e6069/16365_1271139700.jpg);
request.setSpecialLicensePic(SpecialLicensePic);
request.setBusinessLicenseNo("8765445678912903");
FileItem BusinessLicensePic = new FileItem(C:/Downloads/ooopic_963991_7eea1f5426105f9e6069/16365_1271139700.jpg);
request.setBusinessLicensePic(BusinessLicensePic);
FileItem BusinessLicenseAuthPic = new FileItem(C:/Downloads/ooopic_963991_7eea1f5426105f9e6069/16365_1271139700.jpg);
request.setBusinessLicenseAuthPic(BusinessLicenseAuthPic);
request.setLongTerm(true);
request.setDateLimitation("2017-11-11");
FileItem EnterpriseLogo = new FileItem(C:/Downloads/ooopic_963991_7eea1f5426105f9e6069/16365_1271139700.jpg);
request.setEnterpriseLogo(EnterpriseLogo);
request.setEnterpriseAlias("飞猪");
request.setUsageScene("现金放贷,押金减免");
request.setCustomUsageScene("优惠返利");
ContactModel contactModel = new ContactModel();
contactModel.setContactName("张三");
contactModel.setContactMobile("18866668888");
contactModel.setContactEmail("zhangsan@alipy.com");
request.setDrContact(contactModel);
ContactModel contactModel = new ContactModel();
contactModel.setContactName("张三");
contactModel.setContactMobile("18866668888");
contactModel.setContactEmail("zhangsan@alipy.com");
request.setOhContact(contactModel);
ContactModel contactModel = new ContactModel();
contactModel.setContactName("张三");
contactModel.setContactMobile("18866668888");
contactModel.setContactEmail("zhangsan@alipy.com");
request.setPrContact(contactModel);
request.setAppName("应用名称");
FileItem AppDemo = new FileItem(C:/Downloads/ooopic_963991_7eea1f5426105f9e6069/16365_1271139700.jpg);
request.setAppDemo(AppDemo);
request.setWebSites("www.web.com");
request.setAlipayLifeName("杭州XX报社");
request.setWechatOfficialAccountName("杭州XX报社");
AlipayOpenAgentZhimabriefSignResponse response = alipayClient.execute(request);
if(response.isSuccess()){
System.out.println("调用成功");
} else {
System.out.println("调用失败");
}

IAopClient client = new DefaultAopClient("https://openapi.alipay.com/gateway.do", "app_id", "merchant_private_key", "json", "1.0", "RSA2", "alipay_public_key", "GBK", false);
AlipayOpenAgentZhimabriefSignRequest  request= new AlipayOpenAgentZhimabriefSignRequest() ;
request.BatchNo = "2017110616474516400082883";
request.MccCode = "A_A03_4582";
FileItem SpecialLicensePic = new FileItem(C:/Downloads/ooopic_963991_7eea1f5426105f9e6069/16365_1271139700.jpg);
request.setSpecialLicensePic = "-";
request.BusinessLicenseNo = "8765445678912903";
FileItem BusinessLicensePic = new FileItem(C:/Downloads/ooopic_963991_7eea1f5426105f9e6069/16365_1271139700.jpg);
request.setBusinessLicensePic = "-";
FileItem BusinessLicenseAuthPic = new FileItem(C:/Downloads/ooopic_963991_7eea1f5426105f9e6069/16365_1271139700.jpg);
request.setBusinessLicenseAuthPic = "-";
request.LongTerm = true;
request.DateLimitation = "2017-11-11";
FileItem EnterpriseLogo = new FileItem(C:/Downloads/ooopic_963991_7eea1f5426105f9e6069/16365_1271139700.jpg);
request.setEnterpriseLogo = "-";
request.EnterpriseAlias = "飞猪";
request.UsageScene = "现金放贷,押金减免";
request.CustomUsageScene = "优惠返利";
ContactModel contactModel = new ContactModel();
contactModel.contact_name = "张三";
contactModel.contact_mobile = "18866668888";
contactModel.contact_email = "zhangsan@alipy.com";
request.dr_contact = contactModel;
ContactModel contactModel = new ContactModel();
contactModel.contact_name = "张三";
contactModel.contact_mobile = "18866668888";
contactModel.contact_email = "zhangsan@alipy.com";
request.oh_contact = contactModel;
ContactModel contactModel = new ContactModel();
contactModel.contact_name = "张三";
contactModel.contact_mobile = "18866668888";
contactModel.contact_email = "zhangsan@alipy.com";
request.pr_contact = contactModel;
request.AppName = "应用名称";
FileItem AppDemo = new FileItem(C:/Downloads/ooopic_963991_7eea1f5426105f9e6069/16365_1271139700.jpg);
request.setAppDemo = "-";
request.WebSites = "www.web.com";
request.AlipayLifeName = "杭州XX报社";
request.WechatOfficialAccountName = "杭州XX报社";
AlipayOpenAgentZhimabriefSignResponse response=client.execute(request);
Console.WriteLine(response.Body);

$aop = new AopClient ();
$aop->gatewayUrl = 'https://openapi.alipay.com/gateway.do';
$aop->appId = 'your app_id';
$aop->rsaPrivateKey = '请填写开发者私钥去头去尾去回车，一行字符串';
$aop->alipayrsaPublicKey='请填写支付宝公钥，一行字符串';
$aop->apiVersion = '1.0';
$aop->signType = 'RSA2';
$aop->postCharset='GBK';
$aop->format='json';
$request = new AlipayOpenAgentZhimabriefSignRequest ();
$request->setBatchNo("2017110616474516400082883");
$request->setMccCode("A_A03_4582");
$request->setSpecialLicensePic("@"."本地文件路径");
$request->setBusinessLicenseNo("8765445678912903");
$request->setBusinessLicensePic("@"."本地文件路径");
$request->setBusinessLicenseAuthPic("@"."本地文件路径");
$request->setLongTerm(true);
$request->setDateLimitation("2017-11-11");
$request->setEnterpriseLogo("@"."本地文件路径");
$request->setEnterpriseAlias("飞猪");
$request->setUsageScene("现金放贷,押金减免");
$request->setCustomUsageScene("优惠返利");
$contactModel = new ContactModel();
$contactModel->contact_name = $"张三";
$contactModel->contact_mobile = $"18866668888";
$contactModel->contact_email = $"zhangsan@alipy.com";
$request->dr_contact = $contactModel;
$contactModel = new ContactModel();
$contactModel->contact_name = $"张三";
$contactModel->contact_mobile = $"18866668888";
$contactModel->contact_email = $"zhangsan@alipy.com";
$request->oh_contact = $contactModel;
$contactModel = new ContactModel();
$contactModel->contact_name = $"张三";
$contactModel->contact_mobile = $"18866668888";
$contactModel->contact_email = $"zhangsan@alipy.com";
$request->pr_contact = $contactModel;
$request->setAppName("应用名称");
$request->setAppDemo("@"."本地文件路径");
$request->setWebSites("www.web.com");
$request->setAlipayLifeName("杭州XX报社");
$request->setWechatOfficialAccountName("杭州XX报社");
$result = $aop->execute ( $request); 

$responseNode = str_replace(".", "_", $request->getApiMethodName()) . "_response";
$resultCode = $result->$responseNode->code;
if(!empty($resultCode)&&$resultCode == 10000){
echo "成功";
} else {
echo "失败";
}

https://openapi.alipay.com/gateway.do?timestamp=2013-01-01 08:08:08&method=alipay.open.agent.zhimabrief.sign&app_id=4957&sign_type=RSA2&sign=ERITJKEIJKJHKKKKKKKHJEREEEEEEEEEEE&version=1.0&batch_no=
  "2017110616474516400082883"
&mcc_code=
  "A_A03_4582"
&business_license_no=
  "8765445678912903"
&long_term=
  true
&date_limitation=
  "2017-11-11"
&enterprise_alias=
  "飞猪"
&usage_scene=
  [
      "现金放贷","押金减免"
    ]
&custom_usage_scene=
  "优惠返利"
&dr_contact=
  {
"contact_name":"张三",
"contact_mobile":"18866668888",
"contact_email":"zhangsan@alipy.com"
  }
&oh_contact=
  {
"contact_name":"张三",
"contact_mobile":"18866668888",
"contact_email":"zhangsan@alipy.com"
  }
&pr_contact=
  {
"contact_name":"张三",
"contact_mobile":"18866668888",
"contact_email":"zhangsan@alipy.com"
  }
&app_name=
  "应用名称"
&web_sites=
  [
      "www.web.com"
    ]
&alipay_life_name=
  "杭州XX报社"
&wechat_official_account_name=
  "杭州XX报社"

//为确保安全通信，需自行验证响应示例中的sign值是否为蚂蚁金服所提供。

JSON示例

{
	"alipay_open_agent_zhimabrief_sign_response":{
		"msg":"Success",
		"code":"10000"
	},
	"sign":"ERITJKEIJKJHKKKKKKKHJEREEEEEEEEEEE"
}

JSON示例

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

错误码	错误描述	解决方案
INVALID_PARAMETER	参数有误	检查必填参数是否为空，或者长度是否超限
INVALID_BATCH_NO	事务编号 batch_no 不能为空	事务编号参数 batch_no 不能为空
NO_APP_PERMISSION	APPID 不匹配	APPID 不匹配，请检查当前调用的 appId 和创建事务的 appId 是否匹配
BATCH_STATUS_IS_FINAL	事务已经达到终态	请确认事务状态是否是 init 状态，submit\|cancel\|timeout 状态的都是终态，不允许继续进行接口调用。
BATCH_IS_NOT_EXIST	代商户操作事务编号不存在	请检查事务编号是否有效
SYSTEM_ERROR	系统繁忙	系统内部错误，请稍后重试
ISV_APP_NO_ORDER_PACKAGE	第三方应用没有挂载该功能包	请挂载芝麻信用评分（普惠版）功能包
MERCHANT_SIGN_PRODUCT_IN_AUDIT	签约审核中	该商户签约审核中，暂时不能操作，请等签约审核结束后再试！
MERCHANT_SIGN_PRODUCT_IN_FORBIDD	无法进行签	该商户无法签约当前产品，存在产品签约冲突，不允许执行签约
ISV_APP_ORDER_PACKAGE_EMPTY	第三方应用没有任何需要签约开通的功能包	请挂载芝麻信用评分（普惠版）功能包
INVALID_PARAMETER	参数有误	请检查特殊可选参数是否都为空
INVALID_PARAMETER	参数有误非法参数	非法参数
FILE_SIZE_OUT_LIMIT	文件大小超出范围	请检查文件类型的参数大小
FILE_FORMAT_IS_INVALID	文件格式错误	请检查文件类型的参数格式
FILE_SIZE_MIN_LIMIT	文件大小低于范围	请检查文件类型的参数大小
INVALID_PARAMETER	参数有误，1 app_name、app_demo；2 web_sites；3 alipay_life_name；4 wechat_official_account_name，未填写	1 app_name、app_demo；2 web_sites；3 alipay_life_name；4 wechat_official_account_name。1、2、3、4至少选择一个填写
INVALID_PARAMETER	参数有误，使用场景描述和自定义使用场景描述未填写	使用场景描述和自定义使用场景描述至少填写一个

公共错误码

第三方API

alipay.open.agent.zhimabrief.sign (代签约芝麻信用（普惠版）产品)

公共参数

请求参数

公共响应参数

响应参数

请求示例

响应示例

异常示例

业务错误码

公共错误码