文档中心 > API类目 > 电子发票API

alipay.ebpp.invoice.merchantlist.enter.apply (商户批量入驻申请接口)

针对已经在支付宝入驻的服务方,使用该接口导入服务方后面的开票商户

公共参数

请求地址:
环境 HTTPS请求地址
正式环境 https://openapi.alipay.com/gateway.do
公共请求参数:
参数 类型 是否必填 最大长度 描述 示例值
app_id String 32 支付宝分配给开发者的应用ID 2014072300007148
method String 128 接口名称 alipay.ebpp.invoice.merchantlist.enter.apply
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 详见应用授权概述
biz_content String - 请求参数的集合,最大长度不限,除公共参数外所有请求参数都必须放在这个参数中传递,具体参照各产品快速接入文档

请求参数

参数 类型 是否必填 最大长度 描述 示例值
merchant_base MerchantBaseEnterOpenModel 必须 - 商户品牌信息
  • └ m_short_name
  • String
  • 必填
  • 50
  • 商户品牌简称,只能由大写字母、下划线、数字组成,且必须以大写字母开头。
  • MYJF
  • └ m_name
  • String
  • 必填
  • 100
  • 商户品牌全称。
  • 蚂蚁金融服务集团
  • └ logo_info
  • String
  • 可选
  • 10000
  • 商户logo文件流信息,该字段为文件流经base64编码后得到的字符串。
  • /9j/4AAQSkZJRgABAQEASABIAAD/2wBDAA...
sub_merchant_list SubMerchantEnterOpenModel [] 必须 - 商户门店列表信息,最多传入30个门店信息
  • └ sub_m_short_name
  • String
  • 必填
  • 50
  • 商户门店简称,只能由大写字母、下划线、数字组成,且必须以大写字母开头。
  • MYJF_HZ
  • └ sub_m_name
  • String
  • 必填
  • 100
  • 商户门店全称。
  • 杭州蚂蚁金服信息技术有限公司
  • └ register_no
  • String
  • 必填
  • 30
  • 商户门店税号。
  • 91500000747150346A
sub_merchant_common_info SubMerchantCommonEnterOpenModel 必须 - 商户门店入驻产品公共信息
  • └ product_code
  • String
  • 必填
  • 30
  • 商户门店入驻的产品码,QRCODE_MERCHANT_OPEN:企业自建-扫码开票,INVOICE_RETURN:企业自建-发票回传,INVOICE_EXPENSE:发票报销。
  • QRCODE_MERCHANT_OPEN
  • └ s_short_name
  • String
  • 必填
  • 50
  • 商户门店所属的服务方简称。
  • SAD

公共响应参数

参数 类型 是否必填 最大长度 描述 示例值
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");
AlipayEbppInvoiceMerchantlistEnterApplyRequest request = new AlipayEbppInvoiceMerchantlistEnterApplyRequest();
request.setBizContent("{" +
"\"merchant_base\":{" +
"\"m_short_name\":\"MYJF\"," +
"\"m_name\":\"蚂蚁金融服务集团\"," +
"\"logo_info\":\"/9j/4AAQSkZJRgABAQEASABIAAD/2wBDAA...\"" +
"    }," +
"      \"sub_merchant_list\":[{" +
"        \"sub_m_short_name\":\"MYJF_HZ\"," +
"\"sub_m_name\":\"杭州蚂蚁金服信息技术有限公司\"," +
"\"register_no\":\"91500000747150346A\"" +
"        }]," +
"\"sub_merchant_common_info\":{" +
"\"product_code\":\"QRCODE_MERCHANT_OPEN\"," +
"\"s_short_name\":\"SAD\"" +
"    }" +
"  }");
AlipayEbppInvoiceMerchantlistEnterApplyResponse response = alipayClient.execute(request);
if(response.isSuccess()){
System.out.println("调用成功");
} else {
System.out.println("调用失败");
}

响应示例

  • JSON示例
{
	"alipay_ebpp_invoice_merchantlist_enter_apply_response":{
		"msg":"Success",
		"code":"10000"
	},
	"sign":"ERITJKEIJKJHKKKKKKKHJEREEEEEEEEEEE"
}

异常示例

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

业务错误码

错误码 错误描述 解决方案
INVALID_PARAMETER 参数有误 调整入参,稍后重试
SYSTEM_ERROR 系统繁忙 稍后重试
MERCHANT_ENTER_DENY 服务方没有为商户入驻的权限 检查服务方简称是否正确
MERCHANT_NAME_OCCUPIED 商户品牌简称已经被占用 更换品牌简称
SERVER_NOT_EXIST 服务方不存在 检查服务方简称
SERVER_ABILITY_NOT_SATIF 服务方不具备商户入驻产品所需能力 服务方重新入驻
TAX_NUM_OCCUPIED 报销产品下,商户入驻的税号被占用 调整税号,稍后重试
BIZ_ERROR 业务异常,商户批量入驻申请失败,请重试 稍后重试
BIZ_ERROR 业务异常 稍后重试
MERCHANT_LOGO_UPLOAD_FAIL 品牌logo上传失败 检查logo文件流是否正确,稍后重试

公共错误码

返回
顶部