小程序调起支付分-确认订单

更新时间：2025.04.01

商户通过调用确认订单接口打开微信支付分小程序，引导用户确认订单（小程序端）

1. 接口说明

适用对象:机构模式

商户小程序跳转微信侧小程序建议使用方式：调用wx.openBusinessView，不占用小程序跳转其他小程序的数量名额。wx.navigateToMiniProgram现已停止新增，预计将于2024年1月31日下线。

2. wx.openBusinessView接口

接口名称：wx.openBusinessView

接口兼容：

小程序版本库 >= 2.6.0，低版本需提示用户升级微信版本。
iOS兼容性表现：若微信版本 >= 7.0.3，开发者可以通过此openSDK接口跳转到微信支付分小程序；若微信版本 < 7.0.3，开发者通过此openSDK接口可以跳转到微信，但不能跳转到微信支付分小程序，此时微信会提示用户可能由于应用的请求非法或者微信版本过低。
Android兼容性表现：若微信版本 >=7.0.3，开发者可以通过此openSDK接口跳转到微信支付分小程序；若微信版本 < 7.0.3，开发者通过此openSDK接口不能跳转到微信，此时开发者应提示用户更新微信版本。

2.1 接口参数

Object

参数名

变量

类型[长度限制]

必填

描述

跳转类型

businessType

string[1,32]

是

固定配置：wxpayScoreUse。
示例值：wxpayScoreUse

业务参数

extraData

Object

是

需要传递给支付分的业务数据。详细说明见下文

业务参数

2.2 wx.openBusinessView请求示例

1if (wx.openBusinessView) {
2  wx.openBusinessView({
3    businessType: 'wxpayScoreUse',
4    extraData: {
5      mch_id=1230000109&package=XXXXXXXX&
6      timestamp=1530097563&nonce_str=zyx53Nkey8o4bHpxTQvd8m7e92nG5mG2
7      &sign_type=HMAC-SHA256&sign=029B52F67573D7E3BE74904BF9AEA
8    },
9    success() {
10      //dosomething
11    },
12    fail() {
13      //dosomething
14    },
15    complete() {
16      //dosomething
17    }
18  });
19} else {
20  //引导用户升级微信版本
21}

3. wx.navigateToMiniProgram接口

接口名称： wx.navigateToMiniProgram，详见小程序API文档wx.navigateToMiniProgram。

接口兼容：每个小程序可跳转的其他小程序数量限制为不超过 10 个。wx.navigateToMiniProgram的调用方式现已停止新增，预计将于2024年1月31日下线。

3.1 接口参数

Object

参数名

变量

类型[长度限制]

必填

描述

应用ID

appId

string[1,32]

是

支付分公众账号ID，固定配置：wxd8f3793ea3b935b8。
示例值：wxd8f3793ea3b935b8

路径

path

string[1,64]

是

固定配置：pages/use/use
示例值：pages/use/use

业务参数

extraData

Object

是

需要传递给支付分的业务数据。详细说明见下文

业务参数

3.2 wx.navigateToMiniProgram请求示例

1wx.navigateToMiniProgram({
2  appId: 'wxd8f3793ea3b935b8',
3  path: 'pages/use/use',
4  extraData: {
5    mch_id=1230000109&package=XXXXXXXX&
6    timestamp=1530097563&nonce_str=zyx53Nkey8o4bHpxTQvd8m7e92nG5mG2
7    &sign_type=HMAC-SHA256&sign=029B52F67573D7E3BE74904BF9AEA
8  },
9  success() {
10    //dosomething
11  },
12  fail() {
13    //dosomething
14  },
15  complete() {
16    //dosomething
17  }
18});

4. 支付分返回商家侧小程序

触发场景：用户从商户小程序页面进入到支付分后再返回到商户小程序页面。

返回参数：商户小程序可在 App.onLaunch，App.onShow 中获取到这份数据。

4.1 接口参数

参数名	变量	类型[长度限制]	必填	描述
单据查询ID	query_id	string[1,64]	是	单据查询ID，对应《查询支付分订单》接口中入参query_id。

提示

1 带有返回参数不代表订单确认成功，具体状态需以接口查询的结果为准；

2 只有用户点击支付分页面内返回按钮时，才会带上返回参数；如果用户点击页面左上角的返回图标按钮，则不会带上返回参数。

4.2 支付分返回商家侧小程序请求示例

1// app.js
2onShow(res) {
3  if (res.scene === 1038) { // 场景值1038：从被打开的小程序返回
4    const { appId, extraData } = res.referrerInfo;
5    if (appId === miniprogram_appid) { // miniprogram_appid由【创建订单】返回，建议检查是否
6      等于appId，不强制
7      let query_id = extraData.query_id;
8      let result = this.queryOrderStatus(query_id);
9      if (result) {
10        // 成功
11      } else {
12        // 失败
13      }
14    }
15  }
16}
17
18/**
19* 查询订单状态函数
20* 由商家后台服务提供
21* @param query_id {string
22} 单据id，可以在接口【查询订单】进行单据查询
23*/
24queryOrderStatus: function(query_id) {
25  // 商家小程序向商家后台服务请求查询订单状态，
26  // 这里的前后端接口和数据协议由商家侧设计
27  // 函数返回查询结果，这里以布尔值true代表成功，布尔值false代表失败
28}