通用场景
服务商代商家创建小程序,待商家确认后服务商代创建的小程序才会生效,若商家超过确认时间则服务商创建的小程序会自动作废释放占用的小程序名称。
将 is_individual 设置为 true,并且同时传入 license_pic。将同时对具备个体工商户营业执照的商家个人账号认证成为个体工商户账号(创建小程序 升级个体工商户账号一体化)。
将 is_individual 设置为 true,并且同时传入 license_pic。将同时对具备个体工商户营业执照的商家个人账号认证成为个体工商户账号(创建小程序 升级个体工商户账号一体化)。
公共请求参数
业务请求参数
create_mini_request|代创建小程序请求必选createminirequest
【描述】小程序代创建请求
out_order_no|外部订单号必选string[1,128]
【描述】开发者外部订单号,自定义传入,通过开发者账号 outorderno做业务幂等。(1)该字段会在商家确认创建后通过应用授权通知出参notify_context以out_biz_no属性返回给isv,应用授权通知订阅参考:。(2)该字段也会通过返回给订阅方
【示例值】202324353454545
alipay_account|商家支付宝登录id必选string[1,128]
【描述】商家登录支付宝的邮箱帐号或手机号。(1)默认只支持企业账号类型;(2)将is_individual设置为true,支持个体工商户类型的账号(同时也兼容企业账号)(3)将is_individual设置为true且上传营业执照照片,将同时对具备个体工商户营业执照的商家个人账号认证成为个体工商户账号(同时也兼容企业账号、个体工商户账号)
【示例值】test@email.com
legal_personal_name|商家法人名称必选string[1,32]
【描述】商家法人名称
【示例值】张三
cert_name|营业执照企业名称必选string[1,128]
【描述】营业执照企业名称,如果是“无主体名称个体工商户”则填“个体户 法人姓名”,例如“个体户张三”
【示例值】张三科技有限公司
cert_no|营业执照编码必选string[1,256]
【描述】营业执照编码
【示例值】3704354348893534
app_name|小程序名称必选string[1,128]
【描述】小程序名称
【示例值】示例小程序
contact_phone|商家联系人手机电话必选string[1,64]
【描述】商家联系人手机电话
【示例值】199xxxx6338
contact_name|商家联系人名称必选string[1,64]
【描述】商家联系人名称
【示例值】张三
is_individual|是否升级个体工商户可选boolean
【描述】默认为 false。当设置为 true 时,支持个体工商户的账号类型(同时兼容企业账号)
【示例值】true
license_pic|营业执照图片的base64编码字符串可选string[1,2097152]
【描述】营业执照图片的base64编码字符串,图片大小不能超过2m。将is_individual设置为true,当传入该参数后,如果商家账号不是个体工商户类型,将同时为商家升级账号,无需商家额外操作升级(同时支持企业账号、个体工商户账号)
【示例值】/9j/qnl0zufycmf5t3v0chv0u3ryzwftig91dhb1dca9ig5ldybcexrlq中间缩略skge30=
常见请求示例
默认示例
curl 'https://openapi.alipay.com/gateway.do?charset=utf-8&method=alipay.open.mini.isv.create&format=json&sign=${sign}&app_id=${appid}&version=1.0&sign_type=rsa2×tamp=${now}' \
-f 'biz_content={
"create_mini_request":{
"app_name":"示例小程序",
"alipay_account":"test@email.com",
"cert_name":"张三科技有限公司",
"contact_name":"张三",
"cert_no":"3704354348893534",
"license_pic":"/9j/qnl0zufycmf5t3v0chv0u3ryzwftig91dhb1dca9ig5ldybcexrlq中间缩略skge30=",
"contact_phone":"199xxxx6338",
"is_individual":true,
"out_order_no":"202324353454545",
"legal_personal_name":"张三"
}
}'
说明:本示例仅供参考。
公共响应参数
业务响应参数
order_no|申请单号必选string(255)
【描述】小程序代创建订单号
【示例值】2387429847238743
响应示例
正常示例
异常示例
{
"alipay_open_mini_isv_create_response": {
"code": "10000",
"msg": "success",
"order_no": "2387429847238743"
},
"sign": "eritjkeijkjhkkkkkkkhjereeeeeeeeeee"
}
说明:本示例仅供参考。
公共错误码
业务错误码
错误码 | 错误描述 | 凯发app官方网站的解决方案 |
---|---|---|
system_error | 系统繁忙 | 服务器异常 可能发生了网络或者系统异常,导致服务调用失败,商户可以用同样的请求发起重试 |
app_name_duplicated | 应用名称被占用 | 请更换应用名称 |
app_name_length_limit | 应用名称长度超出限制 | 应用名称长度超出限制 |
brand_tort | 应用名称品牌侵权 | 应用名称品牌侵权 |
certificate_invalid | 证件信息非法 | 请检查证件信息是否正确 |
daily_reject_exceeds | 超过商户每日拒绝次数最大限制 | 请与商户确认拒绝原因24小时后再试 |
external_system_error | 外部系统错误,请稍后重试 | 外部系统错误,请稍后重试 |
has_risk | 业务操作存在安全风险 | 业务操作存在风险,请联系凯发app官方网站的技术支持 |
illegal_params | 参数不正确 | 请根据文档仔细检查入参,确保需要的参数均已传入且格式内容均正确 |
info_invalid | 传入值包含敏感信息 | 请检查信息是否符合要求,剔除敏感信息 |
invalid_mini_app_name_length | 应用名称长度非法 | 应用名称长度不合法,请重新输入名称 |
invalid_params | 参数非法 | 请参考文档检查参数是否正确 |
not_unique | 小程序名称重复,小程序名称不可用 | 更换小程序名称 |
ongoing_order_exist | 订单正在处理中 | 订单正在处理中,请等待商家处理已有订单后再试 |
operation_invalid | 应用个数超过最大数量限制 | 应用个数超过最大数量限制 |
order_finished | 订单号错误 | 订单是已结束状态,请重新提交提单号 |
param_invalid | 非法参数 | 请参考文档检查参数是否正确 |
permission_denied | 无操作权限 | 请联系支付宝商务经理获取小程序代创建业务权限 |
provider_role_invalid | 不具备合法的系统服务商身 | 请确认是否拥有开放平台系统服务商身份 |
rate_limiting_risk | 您已被限流,暂无法调用该接口,请稍后再试. | 由于安全管控,您暂不能调用该接口。您可拨打客服热线:95188 |
reject_counts_exceeds | 超过商户拒绝次数最大限制 | 超过24小时最大拒绝次数,请稍后提交 |
rpc_invoke_error | 系统内部异常 | 系统内部异常,请稍后重试 |