alipay.open.agent.mini.create(代商家创建小程序应用) 在线调试(沙箱环境)

ISV 代商户创建小程序应用

公共参数

请求地址

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

公共请求参数

参数 类型 是否必填最大长度描述示例值
app_id String 32 支付宝分配给开发者的应用ID 2014072300007148
method String 128 接口名称 alipay.open.agent.mini.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 详见应用授权概述

请求参数

参数 类型 是否必填 最大长度 描述 示例值
batch_no String 必选 25 ISV 代商家操作事务编号,通过事务开启接口alipay.open.agent.create调用返回。 2017110616474516400082883
app_name String 必选 20 代商家创建的小程序应用名称。名称可以由中文、数字、英文及下划线组成,长度在3-20个字符之间,一个中文字等于2个字符,更多名称规则见:https://docs.alipay.com/mini/operation/name 示例小程序
app_english_name String 必选 20 小程序英文名称,长度3~20个字符 testapp
app_category_ids String 必选 20 小程序应用类目,参数格式:一级类目_二级类目。
应用类目参考文档:https://docs.alipay.com/isv/10325
107397_107223
app_slogan String 必选 32 代商家创建的小程序的简介,请用一句话简要描述小程序提供的服务;应用上架后一个自然月可修改5次(10~32个字符) 测试小程序,专业的小程序
service_phone String 特殊可选 13 商家小程序的客服电话,推荐填写
商家小程序客服电话和邮箱,可以二选一填写,但不能同时为空
0571-12345678
service_email String 特殊可选 64 商家小程序客服邮箱
商家小程序客服电话和邮箱,可以二选一填写,但不能同时为空
test@alipay.com
app_logo Byte_array 必选 262144 商家小程序应用图标,最大256KB,LOGO不允许涉及政治敏感与色情;图片格式必须为:png、jpeg、jpg,建议上传像素为180*180,LOGO核心图形建议在白色160PX范围内 -
app_desc String 必选 200 商家小程序描述信息,简要描述小程序主要功能(20-200个字),例:xx小程序提供了xx功能,主要解决了XX问题。 测试小程序描述信息

响应参数

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

请求示例

AlipayClient alipayClient = new DefaultAlipayClient("https://openapi.alipay.com/gateway.do","app_id","your private_key","json","GBK","alipay_public_key","RSA2");
AlipayOpenAgentMiniCreateRequest request = new AlipayOpenAgentMiniCreateRequest();
request.setBatchNo("2017110616474516400082883");
request.setAppName("示例小程序");
request.setAppEnglishName("testapp");
request.setAppCategoryIds("107397_107223");
request.setAppSlogan("测试小程序,专业的小程序");
request.setServicePhone("0571-12345678");
request.setServiceEmail("test@alipay.com");
FileItem AppLogo = new FileItem("C:/Downloads/ooopic_963991_7eea1f5426105f9e6069/16365_1271139700.jpg");
request.setAppLogo(AppLogo);
request.setAppDesc("测试小程序描述信息");
AlipayOpenAgentMiniCreateResponse response = alipayClient.execute(request);
if(response.isSuccess()){
System.out.println("调用成功");
} else {
System.out.println("调用失败");
}

响应示例

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

异常示例

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

业务错误码

公共错误码

错误码错误描述解决方案
INVALID_PARAMETER 参数有误 检查必填参数是否为空,或者长度是否超限
INVALID_BATCH_NO 事务编号 batch_no 不能为空 事务编号参数 batch_no 不能为空
NO_APP_PERMISSION APPID 不匹配 APPID 不匹配,请检查当前调用的 appId 和创建事务的 appId 是否匹配
BATCH_STATUS_IS_FINAL 事务已经达到终态 请确认事务状态是否是 init 状态,submit|cancel|timeout 状态的都是终态,不允许继续进行接口调用。
APP_INFO_NOT_EXIST 应用信息不存在 请检查 sdk 中配置的应用 appId 是否正确
ISV_APP_NO_TINYAPP_SCENE 第三方应用代理业务范围不包含小程序 请检查第三方应用代理业务范围是否包含小程序,如果不包含,请先添加代理小程序业务范围后,再进行接口调用。
BATCH_IS_NOT_EXIST 代商家操作事务编号不存在 请检查事务编号参数是否有效
MERCHANT_NOT_ENTERPRISE 商家账号类型不是企业账号 商家账号类型不是企业账号,请代企业类型的商家创建小程序
INVALID_PARAMETER 参数有误非法参数 非法参数
APP_NAME_IS_BLANK 应用名称为空 请填写小程序名称
INVALID_MINI_APP_NAME 小程序中文名称包含非法字符 小程序中文名称只能包含中文、数字、英文及下划线
INVALID_MINI_APP_NAME_LENGTH 小程序中文名称长度超出范围 小程序中文名称限制为3-20个字符
MINI_APP_NAME_DUPLICATE 小程序中文名称重名 请重新输入小程序中文名称
MINI_APP_NAME_SENSITIVE 小程序中文名称存在敏感词 请重新输入小程序中文名称
ENGLISH_NAME_IS_BLANK 英文名称为空 请填写小程序英文名称
INVALID_MINI_APP_EN_NAME 小程序英文名称包含非法字符 小程序英文名称只允许英文和数字
INVALID_MINI_APP_EN_NAME_LENGTH 小程序英文名称长度超出范围 请输入合法长度范围的小程序英文名称,3-20个字符
MINI_APP_EN_NAME_DUPLICATE 小程序英文名称重名 请重新输入小程序英文名称
MINI_APP_EN_NAME_SENSITIVE 小程序英文名称包含敏感词 请重新输入小程序英文名称
LOGO_IS_BLANK logo为空 请上传小程序logo
SLOGAN_IS_BLANK 应用简介为空 请填写小程序应用简介
INVALID_MINI_APP_SLOGAN_LENGTH 小程序应用简介长度超出范围 小程序应用简介长度在10-32范围内
INVALID_MINI_APP_SLOGAN 小程序应用简介包含非法字符 请输入合法的小程序应用简介
MINI_APP_SLOGAN_SENSITIVE 小程序应用简介中包含敏感词 请重新填写小程序应用简介
SERVICE_TEL_AND_MAIL_BOTH_BLANK 服务电话和邮箱同时为空 请填写服务电话或者服务邮箱
INVALID_MINI_APP_SERVICE_TEL 小程序服务电话包含非法字符 请重新输入小程序服务电话,只允许包含数字和-,5-30个字符
INVALID_MINI_APP_SERVICE_MAIL 小程序服务邮箱包含非法字符 请重新输入小程序服务邮箱
MINI_APP_SERVICE_MAIL_SENSITIVE 小程序服务邮箱存在敏感词 请重新输入小程序服务邮箱
CATEGORY_IS_BLANK 类目为空 请填写小程序类目
CATEGOTY_NUM_IS_INVALID 小程序类目数量不合法 小程序类目数量需要在1-3之内
INVALID_CATEGORY 非法的类目 请重新输入类目,检查类目是否存在
APP_DESC_IS_BLANK 应用描述为空 请填写应用描述
INVALID_MINI_APP_DESC_LENGTH 小程序应用描述长度非法 小程序应用描述长度在20-200个字内
INVALID_MINI_APP_DESC 小程序应用描述非法 请重新输入小程序应用描述
PID_IS_BLANK 商家ID为空 请填写商家ID
CREATE_MINI_APP_EXCEED_MAX_COUNT 小程序个数超过最大数量 小程序个数超过最大数量
CREATE_MINI_APP_PID_PUNISH 处罚中的用户不能创建小程序 处罚中的用户不能创建小程序
FILE_FORMAT_IS_INVALID 非法的小程序logo格式 小程序logo只支持jpg,jpeg,png格式
FILE_SIZE_OUT_LIMIT 小程序logo大小超出范围 小程序logo大小不得超过256kb
PRE_AUTH_INVALID_AUTH_TICKET 无效的订单授权凭证,状态失效或已过期 订单授权凭证无法使用,请商家重新订购生成新的订单授权凭证使用
PRE_AUTH_INVALID_AUTH_TOKEN 订单授权凭证换取的令牌已失效 商家取消了授权或者令牌被刷新,订单授权凭证无法使用
PRE_AUTH_INVOKE_API_NOT_PERMITTE 该订单授权凭证无权限调用该接口 无接口调用权限
PRE_AUTH_INVALID_CREATE_APPLICAT 订单授权凭证对应代创建应用类型与请求创建应用类型不一致 该订单授权凭证不能用于代创建小程序
PRE_AUTH_INVALID_AUTH_APP_ID 订单授权凭证对应被授权应用与接口调用应用不一致 请将调用接口的应用id更换成订单授权凭证对应的应用id
PRE_AUTH_TICKET_CREATE_APP_ONCE 订单授权凭证只能创建应用一次 订单授权凭证无法使用
BLACK_LIST_CHECK_FAIL 抱歉,当前账户无法新建小程序,具体可联系客服咨询 抱歉,当前账户无法新建小程序,具体可联系客服咨询
RISK_DECISION_CHECK_FAIL 内容涉及不规范用语,请重新修改 请检查提审的应用信息是否存在不规范用语
onlineServer