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 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 详见应用授权概述

请求参数

参数 类型 是否必填 最大长度 描述 示例值
out_biz_no String 必选 64 外部入驻申请单据号,由开发者生成,并需保证在开发者端不重复。另,如果代创建被驳回,需更换新的申请号,原申请号不能再次使用 2016070788301823878
mcc_code String 必选 16 所属MCCCode,详情可参考
商家经营类目 中的“经营类目编码”
A_A01_4121
special_license_pic Byte_array 可选 1.048576e+06 企业特殊资质图片,可参考 商家经营类目 中的 “需要的特殊资质证书” -
business_license_pic Byte_array 可选 1.048576e+06 营业执照图片。被代创建商户运营主体为个人账户必填,企业账户无需填写 -
business_license_auth_pic Byte_array 可选 1.048576e+06 营业执照授权函图片,个体工商户如果使用总公司或其他公司的营业执照认证需上传该授权函图片 -
shop_sign_board_pic Byte_array 可选 1.048576e+06 店铺门头照图片,被代创建商户运营主体为个人账户必填,企业账户选填 -
shop_scene_pic Byte_array 可选 1.048576e+06 店铺内景图片,被代创建商户运营主体为个人账户必填,企业账户选填 -
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_array 必选 1.048576e+06 生活号头像 -
background_pic Byte_array 必选 1.048576e+06 生活号背景图片 -
own_intellectual_pic Byte_array 可选 1.048576e+06 自有知识产权证书图片 -
account String 必选 64 isv代开通生活号的商户支付宝账号或者商户支付宝账号pid(2088开头16位长度的字符串),账号需通过实名认证 13110101010

响应参数

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

请求示例

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("调用失败");
}

响应示例

{
    "alipay_open_public_life_agent_create_response": {
        "code": "10000",
        "msg": "Success",
        "out_biz_no": "201607071212312312"
    },
    "sign": "ERITJKEIJKJHKKKKKKKHJEREEEEEEEEEEE"
}

异常示例

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

业务错误码

公共错误码

错误码错误描述解决方案
BUSINESS_ERROR 系统业务处理错误 稍后重试。如果不能解决,请联系技术支持
INVALID_PARAMETER 参数有误 根据错误详情,修改请求参数后重试
MERCHANT_STATE_NOT_SATISFY 商户被清退或禁止续签,不允许签约 更换可用的商户账号或联系技术支持
UN_SUPPORT_ACCOUNT_LEVEL 签约账号未达到认证级别 签约账号完成认证升级后,再次提交申请
LIFE_APP_CREATE_LIMIT 创建的生活号已达上限 创建的生活号已达到上限,请联系技术支持
APPLY_ORDER_IS_PROCESSING 申请单正在处理中,如果之前为该商户申请过请等待审核结果 调用alipay.open.public.life.agentcreate.query代创建查询接口,查询申请单审核状态,待审核结束后再试
DATA_DUPLICATE 外部入驻申请单据号重复,请更换一个 更换外部入驻申请单据号
LIFE_ILLEGAL_ISV_APP_ID 代商户创建生活号(调接口时传入了app_auth_token),调用主体appid必须是第三方生活号应用 请确定调用主体appid是第三方生活号应用
IMAGE_FORMAT_ERROR 上传图片格式不正确 请上传格式为jpg、jpeg、png、bmp的图片
INVALID_UPLOAD_FILE_SIZE 文件大小超限,请适当压缩图片大小 请根据入参要求,适当压缩图片大小以免超过上传限制
INVALID_MCC_CODE mcc_code为空或格式有误 请检查是否传入正确的mcc_code后再试
ACCOUNT_IS_INVALID 账号无效 请检查商户账号是否正确后再试
LIFE_APP_NAME_EXIST 该生活号名称已存在 更换生活号名称后再试
IMAGE_UPLOAD_ERROR 图片上传失败 图片上传失败,请稍后重试
INVALID_OUT_BIZ_NO out_biz_no为空或长度超限 检查out_biz_no参数
COMMON_FORBIDDEN_ERROR 输入的内容含有敏感词 输入的内容含有敏感词,修改后再试
UN_CERTIFIED_ACCOUNT 支付宝账户未认证 商户账户需要实名认证
INVALID_CONTACT_NAME contact_name为空或长度超限 检查contact_name参数
INVALID_CONTACT_MOBILE contact_mobile为空或格式有误 检查contact_mobile参数
INVALID_CONTACT_EMAIL contact_email为空或格式有误 检查contact_email参数
INVALID_SHOP_SIGN_BOARD_PIC 当运营主体为个人时,shop_sign_board_pic必填 检查shop_sign_board_pic参数
INVALID_SHOP_SCENE_PIC 当运营主体为个人时,shop_scene_pic必填 检查shop_scene_pic参数
INVALID_BUSINESS_LICENSE_PIC 当运营主体为个人时,business_license_pic必填 检查business_license_pic参数
INVALID_PUBLIC_NAME public_name为空或长度超限 检查public_name参数
INVALID_PUBLIC_DESC public_desc为空或长度超限 检查public_desc参数
INVALID_LOGO_PIC logo_url为空 检查logo_url参数
INVALID_BACKGROUND_PIC background_pic为空 检查background_pic参数
CONTRACT_IS_PROCESSING 当前有合约正在处理中,待合约生效后重试 合约正在处理中,如果之前为该商户申请过请等待审核结果
INVALID_BUSINESS_LICENSE_NO 当运营主体为个人时,business_license_no必填,长度在32位以内 检查business_license_no参数
onlineServer