# 小程序确认收货组件接入说明
开发者可通过调用wx.openBusinessView方式在本小程序打开确认收货组件,让用户完成确认收货操作。
接口名称:wx.openBusinessView
接口兼容:
小程序版本库 >= 2.6.0,低版本需提示用户升级到最新的微信版本。
# 接口参数
Object
属性 | 类型 | 必填 | 说明 | |||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
businessType | string | 是 | 固定配置:weappOrderConfirm | |||||||||||||||||||||
extraData | object | 是 | 用于向组件传递用户交易信息,可以选择使用transaction_id或merchant_id+merchant_trade_no来唯一指定要确认收货的订单 | |||||||||||||||||||||
|
# 组件回调
组件通过wx.navigateBackMiniProgram 回调小程序,开发者可以通过App.onShow中处理回调参数。
开发者在接收到确认收货成功的回调后,需要通过查询订单发货状态后台接口再次确认是否完成确认收货,避免出现安全风险。
回调参数在referrerInfo中,其中appid固定为wx1183b055aeec94d1,extraData定义如下:
Object
属性 | 类型 | 必填 | 说明 | |||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
status | string | 是 | "success":用户确认收货成功;"fail":用户确认收货失败;"cancel":用户取消 | |||||||||||||||||||||
errormsg | string | 否 | 当status为fail时的具体错误原因 | |||||||||||||||||||||
req_extradata | object | 是 | 开发者调用组件时的请求信息 | |||||||||||||||||||||
|
# 示例代码
//拉起确认收货组件
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
}
})