# 小程序确认收货组件接入说明

开发者可通过调用wx.openBusinessView方式在本小程序打开确认收货组件,让用户完成确认收货操作。

接口名称:wx.openBusinessView

接口兼容:

小程序版本库 >= 2.6.0,低版本需提示用户升级到最新的微信版本。

# 接口参数

Object

属性 类型 必填 说明
businessType string 固定配置:weappOrderConfirm
extraData object 用于向组件传递用户交易信息,可以选择使用transaction_id或merchant_id+merchant_trade_no来唯一指定要确认收货的订单
属性 类型 必填 说明
transaction_id string 用户交易单号
merchant_id string 用户交易商户号
merchant_trade_no string 商户订单号

# 组件回调

组件通过wx.navigateBackMiniProgram 回调小程序,开发者可以通过App.onShow中处理回调参数。

开发者在接收到确认收货成功的回调后,需要通过查询订单发货状态后台接口再次确认是否完成确认收货,避免出现安全风险。

回调参数在referrerInfo中,其中appid固定为wx1183b055aeec94d1,extraData定义如下:

Object

属性 类型 必填 说明
status string "success":用户确认收货成功;"fail":用户确认收货失败;"cancel":用户取消
errormsg string 当status为fail时的具体错误原因
req_extradata object 开发者调用组件时的请求信息
属性 类型 必填 说明
transaction_id string 用户交易单号
merchant_id string 用户交易商户号
merchant_trade_no string 商户订单号

# 示例代码

//拉起确认收货组件
if (wx.openBusinessView) {
  wx.openBusinessView({
    businessType: 'weappOrderConfirm',
    extraData: {
      merchant_id: '1230000109',
      merchant_trade_no: '1234323JKHDFE1243252',
      transaction_id: '420123123123123123123'
    },
    success() {
      //dosomething
    },
    fail() {
      //dosomething
    },
    complete() {
      //dosomething
    }
  });
} else {
  //引导用户升级微信版本
}

//响应组件回调
App({
  onShow (options) {
    // Do something when show
  }
  })

# 组件样式截图: