小程序调起支付分确认订单页-wx.openBusinessView
更新时间:2024.09.19商户通过创建支付分订单接口获取确认订单的必要参数package后可使用微信支付提供的小程序方法调起微信支付分小程序,引导用户确认订单(小程序端)
# 接口说明
支持商户: 【普通商户】
商户小程序跳转微信侧小程序建议使用wx.openBusinessView的调用方式,不占用小程序跳转其他小程序的数量名额。
兼容性表现说明
- 小程序版本库 >= 2.6.0,低版本需提示用户升级微信版本。
- iOS兼容性表现:若微信版本>=7.0.3,开发者可以通过此openSDK接口跳转到微信支付分小程序;若微信版本< 7.0.3,开发者通过此openSDK接口可以跳转到微信,但不能跳转到微信支付分小程序,此时微信会提示用户可能由于应用的请求非法或者微信版本过低。
- Android兼容性表现:若微信版本>=7.0.3,开发者可以通过此openSDK接口跳转到微信支付分小程序;若微信版本< 7.0.3,开发者通过此openSDK接口不能跳转到微信,此时开发者应提示用户更新微信版本。
接口名称: wx.openBusinessView
# 字段说明
# 请求参数
- businessType 必填固定值,请传入wxpayScoreUse。
- extraData 必填需要传递给支付分的业务数据。
- 属性
wx.openBusinessView 请求示例
1if (wx.openBusinessView) {2 wx.openBusinessView({3 businessType: 'wxpayScoreUse',4 extraData: {5 mch_id: '1230000109',6 package: 'AAQTnZoAAAABAAAAAAD8m2b8VRdZ2kVdKmHNZiAAAABcwQVtru-5k9MmEOZJ_Pv_Nq7Cw56dNKKN5Ej3Knt5jTHF-NdsP_McFW-iaU3iuJ0gWlNQeG9UihoKi0k2pv1t71M6mpk15X6L1545yNpmPD5uhi3poFV8e_5EdYwi_cbc6tXYVfa0AJUO4OzHGPhMdT4ZMwmFFhD0HQi9mRHQhFRKPwFai4NkkW7vm9mv1test',7 timestamp: '1530097563',8 nonce_str: 'zyx53Nkey8o4bHpxTQvd8m7e92nG5mG2',9 sign_type: 'HMAC-SHA256',10 sign: '029B52F67573D7E3BE74904BF9AEA'11 },12 success() {13 //dosomething14 },15 fail() {16 //dosomething17 },18 complete() {19 //dosomething20 }21 });22} else {23 //引导用户升级微信版本24}
# 返回参数
触发场景: 用户从商户小程序页面进入到支付分后再返回到商户小程序页面。
返回参数: 商户小程序可在 App.onLaunch,App.onShow 中获取到这份数据。
- query_id 必填单据查询ID,对应《查询支付分订单》接口中入参query_id。
提示
- 带有返回参数不代表订单确认成功,具体状态需以查询支付分订单接口返回的结果为准;
- 只有用户点击支付分页面内返回按钮时,才会带上返回参数;如果用户点击页面左上角的返回图标按钮,则不会带上返回参数。
返回商家侧小程序请求示例
1// app.js2onShow(res) {3 if (res.scene === 1038) { // 场景值1038:从被打开的小程序返回4 const { appId, extraData } = res.referrerInfo;5 if (appId === miniprogram_appid) { // miniprogram_appid由【创建订单】返回,建议检查是否等于appId,不强制6 let query_id = extraData.query_id;7 let result = this.queryOrderStatus(query_id);8 if (result) {9 // 成功10 } else {11 // 失败12 }13 }14 }15}1617/**18 * 查询订单状态函数19 * 由商家后台服务提供20 * @param query_id {string21} 单据id,可以在接口【查询订单】进行单据查询22 */23queryOrderStatus: function(query_id) {24 // 商家小程序向商家后台服务请求查询订单状态,25 // 这里的前后端接口和数据协议由商家侧设计26 // 函数返回查询结果,这里以布尔值true代表成功,布尔值false代表失败27}
文档是否有帮助