淘宝开放平台 - 文档中心

请求地址：

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

公共请求参数：

参数	类型	是否必填	最大长度	描述	示例值
app_id	String	是	32	支付宝分配给开发者的应用ID	2014072300007148
method	String	是	128	接口名称	ant.merchant.expand.indirect.modify
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	是	-	请求参数的集合，最大长度不限，除公共参数外所有请求参数都必须放在这个参数中传递，具体参照各产品快速接入文档

参数	类型	是否必填	最大长度	描述	示例值
sub_merchant_id	String	特殊可选	16	商户在支付宝入驻成功后，生成的支付宝内全局唯一的商户编号，与external_id二选一	2088101156429885
external_id	String	特殊可选	32	商户编号，由机构定义，需要保证在机构下唯一，与sub_merchant_id二选一	105290059990194
name	String	必须	128	商户名称	xxx信息服务有限公司
alias_name	String	必须	64	商户简称	xx公司
source	String	必须	32	商户来源机构标识，填写机构在支付宝的pid	2088100020003000
business_license	String	可选	20	商户证件编号（企业或者个体工商户提供营业执照，事业单位提供事证号）	100000011234561
service_phone	String	必须	20	商户客服电话	95188
business_license_type	String	可选	32	商户证件类型，取值范围：NATIONAL_LEGAL：营业执照；NATIONAL_LEGAL_MERGE:营业执照(多证合一)；INST_RGST_CTF：事业单位法人证书	NATIONAL_LEGAL
address_info	AddressInfo []	可选	-	商户地址信息
└ province_code String 必填 10 商户所在省份编码，省份编码是与国家统计局一致，请查询: http://www.stats.gov.cn/tjsj/tjbz/tjyqhdmhcxhfdm/ 国标省市区号下载：http://aopsdkdownload.cn-hangzhou.alipay-pub.aliyun-inc.com/doc/2016.xls?spm=a219a.7629140.0.0.qRW4KQ&file=2016.xls 370000 └ city_code String 必填 10 商户所在城市编码，城市编码是与国家统计局一致，请查询: http://www.stats.gov.cn/tjsj/tjbz/tjyqhdmhcxhfdm/ 国标省市区号下载：http://aopsdkdownload.cn-hangzhou.alipay-pub.aliyun-inc.com/doc/2016.xls?spm=a219a.7629140.0.0.qRW4KQ&file=2016.xls 371000 └ district_code String 必填 10 商户所在区县编码，区县编码是与国家统计局一致，请查询: http://www.stats.gov.cn/tjsj/tjbz/tjyqhdmhcxhfdm/ 国标省市区号下载：http://aopsdkdownload.cn-hangzhou.alipay-pub.aliyun-inc.com/doc/2016.xls?spm=a219a.7629140.0.0.qRW4KQ&file=2016.xls 371002 └ address String 必填 256 商户详细经营地址万塘路18号黄龙时代广场B座 └ longitude String 可选 11 经度，浮点型, 小数点后最多保留6位。如需要录入经纬度，请以高德坐标系为准，录入时请确保经纬度参数准确。高德经纬度查询：http://lbs.amap.com/console/show/picker 120.760001 └ latitude String 可选 10 纬度，浮点型,小数点后最多保留6位如需要录入经纬度，请以高德坐标系为准，录入时请确保经纬度参数准确。高德经纬度查询：http://lbs.amap.com/console/show/picker 60.270001 └ type String 可选 32 地址类型。取值范围：BUSINESS_ADDRESS：经营地址（默认） BUSINESS_ADDRESS
contact_info	ContactInfo []	必须	-	商户负责人信息
└ name String 必填 128 联系人名字张三 └ phone String 可选 20 电话 0571-85022088 └ mobile String 可选 20 手机号 13888888888 └ email String 可选 128 电子邮箱 user@domain.com └ tag String [] 必填 6 商户联系人业务标识枚举，表示商户联系人的职责。异议处理接口人:02;商户关键联系人:06;数据反馈接口人:11;服务联动接口人:08 06 └ type String 必填 20 联系人类型，取值范围：LEGAL_PERSON：法人；CONTROLLER：实际控制人；AGENT：代理人；OTHER：其他 LEGAL_PERSON └ id_card_no String 必填 32 身份证号 110000199001011234
bankcard_info	BankCardInfo []	可选	-	商户对应银行所开立的结算卡信息
└ card_no String 必填 20 银行卡号 6228480402637874213 └ card_name String 必填 128 银行卡持卡人姓名张三
pay_code_info	String []	可选	256	受理商户的固定二维码链接地址（即一码多付页面地址，用于后续支付宝营销活动）商户所属的银行或ISV 给商户的二维码url值一码多付方案:https://doc.open.alipay.com/docs/doc.htm?&docType=1&articleId=105672	http://www.domain.com
logon_id	String []	可选	128	受理商户的支付宝账号（用于关联商户生活号、原服务窗，打通口碑营销活动）	user@domain.com
category_id	String	必须	32	商户经营类目，参考文档：https://doc.open.alipay.com/doc2/detail?&docType=1&articleId=105444	2015050700000000
memo	String	可选	512	商户备注信息，可填写额外信息	备注信息

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

参数	类型	是否必填	最大长度	描述	示例值
sub_merchant_id	String	必填	16	商户在支付宝入驻成功后，生成的支付宝内全局唯一的商户编号	2088101156429885

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");
AntMerchantExpandIndirectModifyRequest request = new AntMerchantExpandIndirectModifyRequest();
request.setBizContent("{" +
"\"sub_merchant_id\":\"2088101156429885\"," +
"\"external_id\":\"105290059990194\"," +
"\"name\":\"xxx信息服务有限公司\"," +
"\"alias_name\":\"xx公司\"," +
"\"source\":\"2088100020003000\"," +
"\"business_license\":\"100000011234561\"," +
"\"service_phone\":\"95188\"," +
"\"business_license_type\":\"NATIONAL_LEGAL\"," +
"\"address_info\":[{" +
"\"province_code\":\"370000\"," +
"\"city_code\":\"371000\"," +
"\"district_code\":\"371002\"," +
"\"address\":\"万塘路18号黄龙时代广场B座\"," +
"\"longitude\":\"120.760001\"," +
"\"latitude\":\"60.270001\"," +
"\"type\":\"BUSINESS_ADDRESS\"" +
"}]," +
"\"contact_info\":[{" +
"\"name\":\"张三\"," +
"\"phone\":\"0571-85022088\"," +
"\"mobile\":\"13888888888\"," +
"\"email\":\"user@domain.com\"," +
"\"tag\":[" +
"\"06\"" +
"]," +
"\"type\":\"LEGAL_PERSON\"," +
"\"id_card_no\":\"110000199001011234\"" +
"}]," +
"\"bankcard_info\":[{" +
"\"card_no\":\"6228480402637874213\"," +
"\"card_name\":\"张三\"" +
"}]," +
"\"pay_code_info\":[" +
"\"http://www.domain.com\"" +
"]," +
"\"logon_id\":[" +
"\"user@domain.com\"" +
"]," +
"\"category_id\":\"2015050700000000\"," +
"\"memo\":\"备注信息\"" +
"}");
AntMerchantExpandIndirectModifyResponse 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);
AntMerchantExpandIndirectModifyRequest  request= new AntMerchantExpandIndirectModifyRequest() ;
request.BizContent="{" +
"\"sub_merchant_id\":\"2088101156429885\"," +
"\"external_id\":\"105290059990194\"," +
"\"name\":\"xxx信息服务有限公司\"," +
"\"alias_name\":\"xx公司\"," +
"\"source\":\"2088100020003000\"," +
"\"business_license\":\"100000011234561\"," +
"\"service_phone\":\"95188\"," +
"\"business_license_type\":\"NATIONAL_LEGAL\"," +
"\"address_info\":[{" +
"\"province_code\":\"370000\"," +
"\"city_code\":\"371000\"," +
"\"district_code\":\"371002\"," +
"\"address\":\"万塘路18号黄龙时代广场B座\"," +
"\"longitude\":\"120.760001\"," +
"\"latitude\":\"60.270001\"," +
"\"type\":\"BUSINESS_ADDRESS\"" +
"}]," +
"\"contact_info\":[{" +
"\"name\":\"张三\"," +
"\"phone\":\"0571-85022088\"," +
"\"mobile\":\"13888888888\"," +
"\"email\":\"user@domain.com\"," +
"\"tag\":[" +
"\"06\"" +
"]," +
"\"type\":\"LEGAL_PERSON\"," +
"\"id_card_no\":\"110000199001011234\"" +
"}]," +
"\"bankcard_info\":[{" +
"\"card_no\":\"6228480402637874213\"," +
"\"card_name\":\"张三\"" +
"}]," +
"\"pay_code_info\":[" +
"\"http://www.domain.com\"" +
"]," +
"\"logon_id\":[" +
"\"user@domain.com\"" +
"]," +
"\"category_id\":\"2015050700000000\"," +
"\"memo\":\"备注信息\"" +
"}";
AntMerchantExpandIndirectModifyResponse 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 AntMerchantExpandIndirectModifyRequest ();
$request->setBizContent("{" .
"\"sub_merchant_id\":\"2088101156429885\"," .
"\"external_id\":\"105290059990194\"," .
"\"name\":\"xxx信息服务有限公司\"," .
"\"alias_name\":\"xx公司\"," .
"\"source\":\"2088100020003000\"," .
"\"business_license\":\"100000011234561\"," .
"\"service_phone\":\"95188\"," .
"\"business_license_type\":\"NATIONAL_LEGAL\"," .
"\"address_info\":[{" .
"\"province_code\":\"370000\"," .
"\"city_code\":\"371000\"," .
"\"district_code\":\"371002\"," .
"\"address\":\"万塘路18号黄龙时代广场B座\"," .
"\"longitude\":\"120.760001\"," .
"\"latitude\":\"60.270001\"," .
"\"type\":\"BUSINESS_ADDRESS\"" .
"}]," .
"\"contact_info\":[{" .
"\"name\":\"张三\"," .
"\"phone\":\"0571-85022088\"," .
"\"mobile\":\"13888888888\"," .
"\"email\":\"user@domain.com\"," .
"\"tag\":[" .
"\"06\"" .
"]," .
"\"type\":\"LEGAL_PERSON\"," .
"\"id_card_no\":\"110000199001011234\"" .
"}]," .
"\"bankcard_info\":[{" .
"\"card_no\":\"6228480402637874213\"," .
"\"card_name\":\"张三\"" .
"}]," .
"\"pay_code_info\":[" .
"\"http://www.domain.com\"" .
"]," .
"\"logon_id\":[" .
"\"user@domain.com\"" .
"]," .
"\"category_id\":\"2015050700000000\"," .
"\"memo\":\"备注信息\"" .
"}");
$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=ant.merchant.expand.indirect.modify&app_id=5035&sign_type=RSA2&sign=ERITJKEIJKJHKKKKKKKHJEREEEEEEEEEEE&version=1.0&biz_content=
  {
"sub_merchant_id":"2088101156429885",
"external_id":"105290059990194",
"name":"xxx信息服务有限公司",
"alias_name":"xx公司",
"source":"2088100020003000",
"business_license":"100000011234561",
"service_phone":"95188",
"business_license_type":"NATIONAL_LEGAL",
      "address_info":[{
        "province_code":"370000",
"city_code":"371000",
"district_code":"371002",
"address":"万塘路18号黄龙时代广场B座",
"longitude":"120.760001",
"latitude":"60.270001",
"type":"BUSINESS_ADDRESS"
        }],
      "contact_info":[{
        "name":"张三",
"phone":"0571-85022088",
"mobile":"13888888888",
"email":"user@domain.com",
          "tag":[
            "06"
          ],
"type":"LEGAL_PERSON",
"id_card_no":"110000199001011234"
        }],
      "bankcard_info":[{
        "card_no":"6228480402637874213",
"card_name":"张三"
        }],
      "pay_code_info":[
        "http://www.domain.com"
      ],
      "logon_id":[
        "user@domain.com"
      ],
"category_id":"2015050700000000",
"memo":"备注信息"
  }

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

JSON示例

{
	"sign":"ERITJKEIJKJHKKKKKKKHJEREEEEEEEEEEE",
	"ant_merchant_expand_indirect_modify_response":{
		"msg":"Success",
		"code":"10000",
		"sub_merchant_id":"2088101156429885"
	}
}

JSON示例

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

错误码	错误描述	解决方案
SYSTEM_ERROR	系统繁忙	系统繁忙，请重试
MERCHANT_NULL_ARGUMENT	参数为空	参数为空，请检查
INVALID_PARAMETER	参数有误参数格式非法	参数格式非法，请检查
MERCHANT_NOT_EXISTS	商户信息不存在	受理商户信息不存在，请检查
MERCHANT_SOURCE_ILLEGAL	商户来源不合法，请检查	商户来源不合法，请检查
DISTRICT_CODE_ILLEGAL	地址编号不合法	请按照国家标准填写地址编号信息
MERCHANT_CATEGORY_ILLEGAL	商户经营类目信息非法	商户经营类目信息非法，请检查
MER_ADDRESS_ILLEGAL	商户地址不合规，包含敏感关键词	商户地址不合规，包含敏感关键词，请检查你的录入地址
MER_NAME_ILLEGAL	商户名称或简称不合规，包含敏感关键词	商户名称或简称包含敏感关键词，请检查你的商户名称或简称
ACCOUNT_LEVEL_CHECK_FAILED	M3等级校验失败（身份证信息以及营业执照信息不合法）	商户信息不全，请补充商户信息（营业执照信息、身份证信息必须有一个）
INDIRECT_COUNT_CHECK_FAILED	进件数量超限	商户进件次数超限（请联系支付宝客服）
CERT_INFO_REF_LIMIT_EXCEED	同一证照使用次数超限	商户同一信息使用次数超限（可能是法人或者实际控制人身份证号、营业执照号、受理商户的支付宝账号信息超限）

公共错误码

开放平台

支付API

ant.merchant.expand.indirect.modify (商户分级与信息修改)

公共参数

请求参数

公共响应参数

响应参数

请求示例

响应示例

异常示例

业务错误码

公共错误码