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

更新时间:2023.07.10

商户通过调用确认订单接口打开微信支付分小程序,引导用户确认订单(小程序端)。

# 接口说明

适用对象: 【从业机构(支付机构)】

商户小程序跳转微信侧小程序建议使用两种方式:调用wx.openBusinessView或者wx.navigateToMiniProgram。其中wx.openBusinessView不占用小程序跳转其他小程序的数量名额。

# 1. 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接口不能跳转到微信,此时开发者应提示用户更新微信版本。

# 接口参数

# Object

  • businessType 必填 string(16)
    固定配置:wxpayScoreUse。
  • extraData 必填 Object
    需要传递给支付分的业务数据。
    • 属性

wx.openBusinessView 请求示例

1if (wx.openBusinessView) {
2 wx.openBusinessView({
3 businessType: 'wxpayScoreUse',
4 extraData: {
5 package: 'XXXXXXXX'
6 },
7 success() {
8 //dosomething
9 },
10 fail() {
11 //dosomething
12 },
13 complete() {
14 //dosomething
15 }
16 });
17} else {
18 //引导用户升级微信版本
19}

# 2. wx.navigateToMiniProgram

接口名称: wx.navigateToMiniProgram,详见小程序API文档 (opens new window)

接口兼容: 每个小程序可跳转的其他小程序数量限制为不超过 10 个。

# 接口参数

# Object

  • appId 必填 string(32)
    支付分公众账号ID,固定配置:wxd8f3793ea3b935b8。
  • path 必填 string(64)
    固定配置:pages/use/use
  • extraData 必填 Object
    需要传递给支付分的业务数据。
    • 属性

wx.navigateToMiniProgram 请求示例

1wx.navigateToMiniProgram({
2 appId: 'wxd8f3793ea3b935b8',
3 path: 'pages/use/use',
4 extraData: {
5 package: 'XXXXXXXX',
6 },
7 success() {
8 //dosomething
9 },
10 fail() {
11 //dosomething
12 },
13 complete() {
14 //dosomething
15 }
16});

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

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

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

# 接口参数

# Object

  • query_id 必填 string(64)
    单据查询ID,对应【查询订单】接口中入参query_id。

注意

  1. 带有返回参数不代表订单确认成功,具体状态需以接口查询的结果为准;
  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由【[创建订单](/partner/apis/partner-institution-weixin-pay-score/acquiring-bank-service-order/create-acquiring-bank-service-order.html)】返回,建议检查是否等于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}
16
17/**
18 * 查询订单状态函数
19 * 由商家后台服务提供
20 * @param query_id {string
21} 单据id,可以在接口【查询订单】进行单据查询
22 */
23queryOrderStatus: function(query_id) {
24 // 商家小程序向商家后台服务请求查询订单状态,
25 // 这里的前后端接口和数据协议由商家侧设计
26 // 函数返回查询结果,这里以布尔值true代表成功,布尔值false代表失败
27}