wx.navigateToMiniProgram(停止新增)
更新时间:2024.10.15商户通过商户预授权接口获取授权的必要参数apply_permissions_token后,可使用微信支付提供的小程序方法调起微信支付分小程序,引导用户确认订单(小程序端)
# 接口说明
支持商户: 【普通商户】
2024年1月31日后接入的商户已无法使用wx.navigateToMiniProgram接口,商户需调用wx.openBusinessView接口来实现从商户小程序跳转到微信支付分小程序。
兼容性表现说明
- 小程序版本库 >= 2.6.0,低版本需提示用户升级微信版本。
- iOS兼容性表现:若微信版本>=7.0.3,开发者可以通过此openSDK接口跳转到微信支付分小程序;若微信版本< 7.0.3,开发者通过此openSDK接口可以跳转到微信,但不能跳转到微信支付分小程序,此时微信会提示用户可能由于应用的请求非法或者微信版本过低。
- Android兼容性表现:若微信版本>=7.0.3,开发者可以通过此openSDK接口跳转到微信支付分小程序;若微信版本< 7.0.3,开发者通过此openSDK接口不能跳转到微信,此时开发者应提示用户更新微信版本。
接口名称: wx.navigateToMiniProgram,详见小程序API文档 (opens new window)。
特别提醒
每个小程序可跳转的其他小程序数量限制为不超过 10 个。
# 字段说明
# 请求参数
- appId 必填支付分小程序appid,固定值,请传入wxd8f3793ea3b935b8。
- path 必填固定配置:pages/use/enable
- extraData 必填需要传递给支付分的业务数据。
- 属性
wx.navigateToMiniProgram 请求示例
1wx.navigateToMiniProgram({2 appId: 'wxd8f3793ea3b935b8',3 path: 'pages/use/enable',4 extraData: {5 package: 'apply_permissions_token=AAQTnZoAAAABAAAAAAA-82Zwq2wMeohrOrWEZiAAAABcwQVtru-5k9MmEOZJ_Pv_Nq7Cw56dNKKN5EjZKnt5jf2ELJMexxwojyqA5EXan-WSwpRhLgBZYm-e9iZ7nLLhTzJLT4qakuzmTPoY64kYxO-8G7Frx8D3sScFf7QOZt8ZMnyXGF-jHx6TMjlGdWti6K0jqAYp_CyALFJxBrEbOvLlJ_vdllvc33W5XV8'6 },7 success() {8 //dosomething9 },10 fail() {11 //dosomething12 },13 complete() {14 //dosomething15 }16})
返回商家侧小程序请求示例
1// app.js2onShow(res) {3 if (res.scene === 1038) { // 场景值1038:从被打开的小程序返回4 const { appId, extraData } = res.referrerInfo; 5 if (appId === miniprogram_appid) { // miniprogram_appid是支付分小程序appid(固定wxd8f3793ea3b935b8),建议检查是否等于来源appId(等于时代表从支付分小程序返回),不强制6 let result = this.queryAuthorizationStatus(authorization_code);7 if (result) {8 // 成功9 } else {10 // 失败11 }12 }13 }14}1516/**17 * 查询用户授权状态函数18 * 由商家后台服务提供19 * @param authorization_code {string20} 授权协议号,商户预授权时生成的授权单号,拉起授权前商户前端保存,用于后续查询授权结果21 */22queryAuthorizationStatus: function(authorization_code) {23 // 商家小程序向商家后台服务请求查询用户授权状态,24 // 这里的前后端接口和数据协议由商家侧设计25 // 函数返回查询结果,这里以布尔值true代表成功,布尔值false代表失败26}
文档是否有帮助