微信支付分接口文档

跳转方式

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

1.1 wx.openBusinessView

接口名称: wx.openBusinessView
接口兼容: 小程序版本库 >= 2.6.0，低版本需提示用户升级微信版本。

接口参数

字段名	必填	类型	示例值	说明
businessType	是	String	wxpayScoreUse	固定配置：wxpayScoreUse
extraData	是	Object		需要传递给目标小程序的数据
envVersion	否	String	release	要打开的小程序版本。仅在当前小程序为开发版或体验版时此参数有效。如果当前小程序是正式版，则打开的小程序必定是正式版

object.extraData

字段名必填类型示例值说明

mch_id 是 String 1230000109 微信支付分配的商户号

package 是 String XXXXXXXX 可在【创建订单】接口的返回字段package中获取

timestamp 是 String 1530097563 生成签名时间戳，单位秒

nonce_str 是 String zyx53Nkey8o4bHpxTQvd8m7e92nG5mG2 生成签名随机串。由数字、大小写字母组成，长度不超过32位

sign_type 是 String HMAC-SHA256 签名类型。仅支持HMAC-SHA256

sign 是 String 029B52F67573D7E3BE74904BF9AEA 使用字段mch_id、package、timestamp、nonce_str、sign_type按照签名生成算法计算得出的签名值

object.envVersion 的合法值

值说明

release 正式版

示例代码：

 
if (wx.openBusinessView) {
  wx.openBusinessView({
    businessType: 'wxpayScoreUse',
    extraData: {
      mch_id: '1230000109',
      package: 'XXXXXXXX',
      timestamp: '1530097563',
      nonce_str: 'zyx53Nkey8o4bHpxTQvd8m7e92nG5mG2',
      sign_type: 'HMAC-SHA256',
      sign: '029B52F67573D7E3BE74904BF9AEA'
    },
    envVersion: 'release',
    success() {
      //dosomething
    }，
    fail() {
      //dosomething
    }，
    complete() {
      //dosomething
    }
  });
} else {
  //引导用户升级微信版本
}

1.2 wx.navigateToMiniProgram

接口名称: wx.navigateToMiniProgram，详见小程序API文档
接口限制: :每个小程序可跳转的其他小程序数量限制为不超过 10 个。

接口参数

字段名	必填	类型	示例值	说明
appId	是	String	wxd8f3793ea3b935b8	固定配置，可在【创建订单】接口的返回字段miniprogram_appid中获取
path	是	Sting	pages/use/use	固定配置，可在【创建订单】接口的返回字段miniprogram_path中获取
extraData	是	Object		需要传递给目标小程序的数据
envVersion	否	String	release	要打开的小程序版本。仅在当前小程序为开发版或体验版时此参数有效。如果当前小程序是正式版，则打开的小程序必定是正式版

object.extraData

字段名	必填	类型	示例值	说明
mch_id	是	String	1230000109	微信支付分配的商户号
package	是	String	XXXXXXXX	可在【创建订单】接口的返回字段package中获取
timestamp	是	String	1530097563	生成签名时间戳，单位秒
nonce_str	是	String	zyx53Nkey8o4bHpxTQvd8m7e92nG5mG2	生成签名随机串。由数字、大小写字母组成，长度不超过32位
sign_type	是	String	HMAC-SHA256	签名类型。仅支持HMAC-SHA256
sign	是	String	029B52F67573D7E3BE74904BF9AEA	使用字段mch_id、package、timestamp、nonce_str、sign_type按照签名生成算法计算得出的签名值

值	说明
release	正式版

示例代码：


wx.navigateToMiniProgram({
  appId: 'wxd8f3793ea3b935b8',
  path: 'pages/use/use',
  extraData: {
    mch_id: '1230000109',
    package: 'XXXXXXXX',
    timestamp: '1530097563',
    nonce_str: 'zyx53Nkey8o4bHpxTQvd8m7e92nG5mG2',
    sign_type: 'HMAC-SHA256',
    sign: '029B52F67573D7E3BE74904BF9AEA'
  },
  envVersion: 'release',
  success() {
    //dosomething
  },
  fail() {
    //dosomething
  },
  complete() {
    //dosomething
  }
});

1.3 微信侧小程序返回商家侧小程序

触发场景:用户从商户小程序页面进入到微信侧小程序后再返回到商户小程序页面
返回参数:商户小程序可在 App.onLaunch，App.onShow 中获取到这份数据

返回参数

字段名	必填	类型	示例值	说明
query_id	是	String	XXXXXXXX	单据查询id，对应【查询订单】接口中入参query_id

注意：只有用户点击微信侧小程序页面内返回按钮时，才会带上返回参数；如果用户点击页面左上角的返回图标按钮，则不会带上返回参数
代码示例：


// app.js
onShow(res) {
  if (res.scene === 1038) { // 场景值1038：从被打开的小程序返回
    const { appId, extraData } = res.referrerInfo;
    if (appId === miniprogram_appid) { // miniprogram_appid由【创建订单】返回，建议检查是否等于appId，不强制
      let query_id = extraData.query_id;
      let result = this.queryOrderStatus(query_id);
      if (result) {
        // 成功
      } else {
        // 失败
      }
    }
  }
}

/**
 * 查询订单状态函数
 * 由商家后台服务提供
 * @param query_id {String} 单据id，可以在接口【查询订单】进行单据查询
 */
queryOrderStatus: function(query_id) {
  // 商家小程序向商家后台服务请求查询订单状态，
  // 这里的前后端接口和数据协议由商家侧设计
  // 函数返回查询结果，这里以布尔值true代表成功，布尔值false代表失败
}

微信支付开发文档

商户小程序跳转微信侧小程序-确认订单

跳转方式

1.1 wx.openBusinessView

接口参数

1.2 wx.navigateToMiniProgram

接口参数

1.3 微信侧小程序返回商家侧小程序

返回参数