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
pid String 特殊可选 30 开票商户pid,入驻支付即开票场景的时候,该字段必传 2088102143353534
sub_merchant_common_info SubMerchantCommonEnterOpenModel 必选 商户门店入驻产品公共信息
product_code String 必填 30 商户门店入驻的产品码,QRCODE_MERCHANT_OPEN:企业自建-扫码开票,INVOICE_RETURN:企业自建-发票回传,INVOICE_EXPENSE:发票报销,PAYMENT_OPEN:支付即开票。 QRCODE_MERCHANT_OPEN
s_short_name String 必填 50 商户门店所属的服务方简称。 SAD

响应参数

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

请求示例

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\"," +
"\"pid\":\"2088102143353534\"" +
"        }]," +
"\"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("调用失败");
}

响应示例

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

异常示例

{
    "alipay_ebpp_invoice_merchantlist_enter_apply_response": {
        "code": "20000",
        "msg": "Service Currently Unavailable",
        "sub_code": "isp.unknow-error",
        "sub_msg": "系统繁忙"
    },
    "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文件流是否正确,稍后重试
onlineServer