接入指引


自定义版组件的接入需要经过上面所示的8个步骤,在每一个步骤中需要完成对应动作:

请确保每一个步骤都已经完成,尤其是全量商品的上传,不然会影响小程序的正常经营

1.申请接入

在微信公众平台注册小程序,根据指引填写信息和提交相应的资料,完成注册流程,若已有小程序,可直接使用。前往注册小程序

微信公众平台登录小程序,选择自定义版交易组件,并申请开通功能,进入审核流程。商家也可以通过调用申请接入的接口申请开通功能。


2.调用开放接口,完成接入

申请通过后,需要小程序开发者调用自定义版组件接口,包含:

  • 商品相关接口:商品添加、商品修改、商品上架、商品下架、商品更新等
  • 订单相关接口:生成订单及ticket、订单的状态同步、订单获取等
  • 资质相关接口:品牌资质上传、类目资质上传、商品资质上传等
  • 物流及售后相关接口:物流信息同步、售后单生成、售后情况同步等

添加流程及逻辑

小程序必须要在分支流程 app.json 中添加

"usingShopPlugin": true;

同时,开发者还需要对拉起小程序微信支付收银台接口做一些调整,需要新增ticket字段信息的传入才能正常调起收银台

    wx.requestPayment({
        timeStamp: '',
        nonceStr: '',
        package: '',
        signType: 'MD5',
        paySign: '',
        ticket: '', // 需要新增的 ticket 信息
        success (res) { },
        fail (res) { }
    }) 

3.上传商品

接口接入后,建议商家先将全量商品进行上传,上传后,每个商品的审核状态将会通知至商家端。


4.提交审核和发布

完成接口对接及商品上传后,提交代码至微信团队审核,审核通过后即可发布。


5.使用交易组件

成功发布小程序后,需要进入微信公众平台中,在左侧菜单>交易组件>自定义版交易组件中点击“使用交易组件”按钮,完成完整的自定义版交易组件的接入。

开发者也可以调用开关ticket校验接口完成使用交易组件的操作。


6.生成订单

成功接入自定义版交易组件后,用户下单时,将会成功生成交易订单。


7.订单状态同步

开发者需要将第6步生成的订单状态进行流转、同步


8.售后信息同步

开发这需要将产生售后了的订单售后信息进行流转、同步,如若没有产生售后,则不需要。

退出自定义版交易组件逻辑

添加流程及逻辑

小程序必须要在分支流程 app.json 中删除

"usingShopPlugin": true;