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 |