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= |
| 参数 | 类型 | 是否必填 | 最大长度 | 描述 | 示例值 |
|---|
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("调用失败");
}
{
"sign":"ERITJKEIJKJHKKKKKKKHJEREEEEEEEEEEE",
"alipay_open_agent_mini_create_response":{
"msg":"Success",
"code":"10000"
}
}
{
"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 |