文档中心 > API类目 > 生活号(原服务窗)API

alipay.open.public.life.agent.create (isv代创建生活号接口)

isv调用该接口代商户创建生活号,创建生活号工单审核状态以“isv代创建生活号申请状态查询接口”为准,工单审核通过后,支付宝会发一封授权邮件至商户邮箱,商户确认授权后,支付宝会发送服务市场通知至isv生活号应用网关,isv可以从通知中获取商户生活号的appid、pid、app_auth_token等信息

公共参数

请求地址:
环境 HTTPS请求地址
正式环境 https://openapi.alipay.com/gateway.do
公共请求参数:
参数 类型 是否必填 最大长度 描述 示例值
app_id String 32 支付宝分配给开发者的应用ID 2014072300007148
method String 128 接口名称 alipay.open.public.life.agent.create
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 详见应用授权概述

请求参数

参数 类型 是否必填 最大长度 描述 示例值
out_biz_no String 必须 64 外部入驻申请单据号,由开发者生成,并需保证在开发者端不重复。另,如果代创建被驳回,需更换新的申请号,原申请号不能再次使用 2016070788301823878
mcc_code String 必须 16 所属MCCCode,详情可参考
商家经营类目 中的“经营类目编码”
A_A01_4121
special_license_pic byte[] 可选 1048576 企业特殊资质图片,可参考 商家经营类目 中的 “需要的特殊资质证书” -
business_license_pic byte[] 可选 1048576 营业执照图片。被代创建商户运营主体为个人账户必填,企业账户无需填写 -
business_license_auth_pic byte[] 可选 1048576 营业执照授权函图片,个体工商户如果使用总公司或其他公司的营业执照认证需上传该授权函图片 -
shop_sign_board_pic byte[] 可选 1048576 店铺门头照图片,被代创建商户运营主体为个人账户必填,企业账户选填 -
shop_scene_pic byte[] 可选 1048576 店铺内景图片,被代创建商户运营主体为个人账户必填,企业账户选填 -
contact_name String 必须 20 企业联系人名称 张三
contact_mobile String 必须 16 联系人手机号 13110101010
contact_email String 必须 64 联系人邮箱 example@mail.com
public_name String 必须 20 生活号名称 xxx生活号
public_desc String 必须 100 生活号简介 生活号简介
logo_pic byte[] 必须 1048576 生活号头像 -
background_pic byte[] 必须 1048576 生活号背景图片 -
own_intellectual_pic byte[] 可选 1048576 自有知识产权证书图片 -
account String 必须 64 isv代开通生活号的商户支付宝账号或者商户支付宝账号pid(2088开头16位长度的字符串),账号需通过实名认证 13110101010

公共响应参数

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

响应参数

参数 类型 是否必填 最大长度 描述 示例值
out_biz_no String 必填 32 外部入驻申请单据号 201607071212312312

请求示例

  • 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");
AlipayOpenPublicLifeAgentCreateRequest request = new AlipayOpenPublicLifeAgentCreateRequest();
request.setOutBizNo("2016070788301823878");
request.setMccCode("A_A01_4121");
FileItem SpecialLicensePic = new FileItem(C:/Downloads/ooopic_963991_7eea1f5426105f9e6069/16365_1271139700.jpg);
request.setSpecialLicensePic(SpecialLicensePic);
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);
FileItem ShopSignBoardPic = new FileItem(C:/Downloads/ooopic_963991_7eea1f5426105f9e6069/16365_1271139700.jpg);
request.setShopSignBoardPic(ShopSignBoardPic);
FileItem ShopScenePic = new FileItem(C:/Downloads/ooopic_963991_7eea1f5426105f9e6069/16365_1271139700.jpg);
request.setShopScenePic(ShopScenePic);
request.setContactName("张三");
request.setContactMobile("13110101010");
request.setContactEmail("example@mail.com");
request.setPublicName("xxx生活号");
request.setPublicDesc("生活号简介");
FileItem LogoPic = new FileItem(C:/Downloads/ooopic_963991_7eea1f5426105f9e6069/16365_1271139700.jpg);
request.setLogoPic(LogoPic);
FileItem BackgroundPic = new FileItem(C:/Downloads/ooopic_963991_7eea1f5426105f9e6069/16365_1271139700.jpg);
request.setBackgroundPic(BackgroundPic);
FileItem OwnIntellectualPic = new FileItem(C:/Downloads/ooopic_963991_7eea1f5426105f9e6069/16365_1271139700.jpg);
request.setOwnIntellectualPic(OwnIntellectualPic);
request.setAccount("13110101010");
AlipayOpenPublicLifeAgentCreateResponse response = alipayClient.execute(request);
if(response.isSuccess()){
System.out.println("调用成功");
} else {
System.out.println("调用失败");
}

响应示例

  • JSON示例
{
	"sign":"ERITJKEIJKJHKKKKKKKHJEREEEEEEEEEEE",
	"alipay_open_public_life_agent_create_response":{
		"msg":"Success",
		"code":"10000",
		"out_biz_no":"201607071212312312"
	}
}

异常示例

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

业务错误码

错误码 错误描述 解决方案
SYSTEM_ERROR 系统繁忙 重试
INVALID_PARAMETER 参数有误 根据错误详情,修改请求参数后重试
MERCHANT_STATE_NOT_SATISFY 商户被清退或禁止续签,不允许签约 更换签约账号
UN_SUPPORT_ACCOUNT_LEVEL 签约账号未达到认证级别 签约账号完成认证升级后,再次提交申请
ANT_PRODUCT_CONFLICT 签约冲突 账号已经签约了相关产品
APPLY_ORDER_IS_PROCESSING 申请单正在处理中 请调用查询接口,查询申请单状态
DATA_DUPLICATE 申请单已存在 更换外部入驻申请单据号
LIFE_ILLEGAL_ISV_APP_ID 不是第三方生活号应用,不允许代创建生活号 请使用有第三方创建生活号权限的isv账号再试
IMAGE_FORMAT_ERROR 上传图片格式不正确 请上传格式为jpg、jpeg、png、bmp、gif的图片
INVALID_UPLOAD_FILE_SIZE 文件大小超出范围,请重新上传 图片大小限制1M,请适当压缩图片大小以免超过上传限制
INVALID_MCC_CODE mcc_code错误 请检查是否传入正确的mcc_code后再试
ACCOUNT_IS_INVALID 账号无效 请检查账号是否正确后再试
LIFE_APP_NAME_EXIST 该生活号名称已存在 更换生活号名称后再试
IMAGE_UPLOAD_ERROR 图片上传失败,请重试 图片上传失败,请重试

公共错误码

返回
顶部