文档中心 > API类目 > 第三方API

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[] 必须 262144 商户小程序应用图标,最大256KB,LOGO不允许涉及政治敏感与色情;图片格式必须为:png、jpeg、jpg,建议上传像素为180*180,LOGO核心图形建议在白色160PX范围内 -
app_desc String 可选 500 商户小程序描述信息,简要描述小程序主要功能(20-500个字),例:xx小程序提供了xx功能,主要解决了XX问题。 测试小程序描述信息

公共响应参数

参数 类型 是否必填 最大长度 描述 示例值
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");
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("调用失败");
}

响应示例

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

异常示例

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

业务错误码

错误码 错误描述 解决方案
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

公共错误码

返回
顶部