配置应用
- 登录 ,进入 第三方应用详情 > 产品绑定,确保产品列表中已添加 小程序。若没有,则点击 绑定产品 添加产品。
- 进入 第三方应用详情 > 开发设置 > 消息服务 > from 平台,订阅 alipay.open.mini.merchant.confirmed(商户确认服务商代创建小程序结果通知)通知,用于接收商家确认的结果通知,详情可查看 from 蚂蚁消息服务使用。
准备商家资料
小程序创建前需要准备以下资料:
- 商家登录支付宝的邮箱账号或手机号(支持支付宝企业账号和具备个体工商户营业执照的支付宝个人账号);
- 商家法人名称;
- 营业执照企业名称;
- 营业执照编码;
- 小程序名称;
- 商家联系人手机电话;
- 商家联系人名称;
- 商家营业执照照片(可选,用于将商家个人账号升级成个体工商户账号)。
- 服务商调用 alipay.open.mini.isv.create(isv 服务商代商户创建小程序)接口,传入收集的商家信息,协助商家创建小程序。
注意:
- 若商家的营业执照名称为空,应按照规则补充对应内容,填写规则为 个体户 法人名称 ,例如 个体户张三。
- is_individual 参数控制账号校验时是否允许商家账号是个体工商户,若商家账号是由个人账号升级的个体工商户账号,需传入
is_individual:ture
进行校验。 - 将is_individual设置为true,并且同时传入license_pic,将同时支持将具备个体工商户营业执照的商家个人账号认证成为个体工商户账号。
示例代码
alipayclient alipayclient = new defaultalipayclient("https://openapi.alipay.com/gateway.do","app_id","your private_key","json","gbk","alipay_public_key","rsa2"); alipayopenminiisvcreaterequest request = new alipayopenminiisvcreaterequest(); request.setbizcontent("{" " \"create_mini_request\":{" " \"out_order_no\":\"202324353454545\"," " \"alipay_account\":\"test@email.com\"," " \"legal_personal_name\":\"张三\"," " \"cert_name\":\"张三科技有限公司\"," " \"cert_no\":\"3704354348893534\"," " \"app_name\":\"张三的小程序\"," " \"contact_phone\":\"19925376338\"," " \"contact_name\":\"张三\"," " \"is_individual\":true" " }" "}"); alipayopenminiisvcreateresponse response = alipayclient.execute(request); if(response.issuccess()){ system.out.println("调用成功"); } else { system.out.println("调用失败"); }
- 申请通过后,系统会发送确认消息(app push)到商家的支付宝账号。商家在支付宝 app 中登录调用接口时传入 alipay_account 的账号,点击消息进入小程序授权确认页面,点击 确认处理待办,并输入支付密码进行确认,即可完成小程序的创建,并同时完成代开发授权给服务商的第三方应用。
若商家点击 确认处理待办 后,创建小程序失败,服务商可以重新发起,再次创建。
说明:
- 商家24小时内未确认,则该次工单失效,可以重新发起;
- 如果商家点击确认之后出现失败的情况,则该次工单失效,可以重新发起;
- 如果商家未收到确认消息,商家可打开支付宝客户端搜索 商家平台消息中心 小程序,点击 待办任务 查收确认消息。
- 商家确认后,服务商的应用网关会收到 alipay.open.mini.merchant.confirmed(商户确认服务商代创建小程序结果通知)和 授权通知,服务商解析获取授权通知中的 app_auth_token(授权令牌)。
说明:完成创建小程序后,若需查询或修改小程序信息,可调用如下接口:
- 查询小程序信息:alipay.open.mini.baseinfo.query(查询小程序基础信息)
- 修改小程序信息:alipay.open.mini.baseinfo.modify(小程序修改基础信息)
服务商调用 alipay.open.mini.isv.query(isv 查询代商家创建小程序记录)接口,传入 order_no(订单编号)参数,查询该订单协助创建小程序的情况。
示例代码
alipayclient alipayclient = new defaultalipayclient("https://openapi.alipay.com/gateway.do","app_id","your private_key","json","gbk","alipay_public_key","rsa2"); alipayopenminiisvqueryrequest request = new alipayopenminiisvqueryrequest(); request.setbizcontent("{" " \"order_no\":\"2394834823942343\"" "}"); alipayopenminiisvqueryresponse response = alipayclient.execute(request); if(response.issuccess()){ system.out.println("调用成功"); } else { system.out.println("调用失败"); }
返回的 status 参数表示创建小程序的状态。
process(处理中)
商家 24 小时内暂未确认,可提醒商家进行确认。
timeout(超时)
商家超过 24 小时未确认,需重新调用创建接口,发起新的申请流程。
agreed(同意)
商家已同意。
rejected(拒绝)
商家已拒绝。
","margin":false,"hideborder":false,"id":"hmdfg"}" id="hmdfg">process(处理中) | 商家 24 小时内暂未确认,可提醒商家进行确认。 |
timeout(超时) | 商家超过 24 小时未确认,需重新调用创建接口,发起新的申请流程。 |
agreed(同意) | 商家已同意。 |
rejected(拒绝) | 商家已拒绝。 |