本文档主要介绍自定义交易组件的接入流程及要注意的事项,帮助运营/业务人员更好的了解接入逻辑及流程,高效且顺利的接入组件,实现视频号直播带货等。

# 注意:整个接入流程需要5-15个工作日不等,建议提前准备商品的品牌、资质、类目信息,与开发调试并行,避免耽搁直播带货计划。

# 整体接入流程


自定义版交易组件的完整接入需要经过上面所示的四个部分,17个步骤,在每一个步骤中需要完成对应动作。


# 前置流程:接入准备

# 检查是否已经开通标准版

微信公众平台登录小程序,在“交易组件”菜单中检查是否已经开通了标准版交易组件,标准版交易组件和自定义版交易组件二选一。下图所示为已经开通了标准版交易组件情况。


如果已经开通了标准版交易组件,但是没有完成开张任务,则可以取消使用,如下图所示,若已经完成开张任务,则需要等待注销功能。(目前暂无注销功能)


# 1:完成自定义版交易组件开通申请

# 1.1 申请接入

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

若小程序满足自定义版交易组件的接入要求,在微信公众平台登录小程序,则会看到下图所示界面:


选择自定义版交易组件,并申请开通功能,进入审核流程。商家也可以通过调用申请接入的接口申请开通功能,申请并审核通过后会看到下面的界面。

# 注意:这里申请审核时效为1-2个工作日,如果已经接入了回调接口,则会收到申请通过的回调。

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

  • a. 商品相关接口:商品添加、商品修改、商品上架、商品下架、商品更新等
  • b. 订单相关接口:生成订单、获取支付参数、订单的状态同步、订单获取等
  • c. 资金相关接口:管理资金、查看详情、发起提现、修改账户等
  • d. 资质相关接口:品牌资质上传、类目资质上传、商品资质上传等
  • e. 物流及售后相关接口:物流信息同步、售后单生成、售后情况同步等
  • f. 事件回调接口:用以接收商品审核,类目审核,品牌审核结果同步等
# 注意:所有接口都需要接入及联调,避免影响正常经营
# 注意:如果通过接口调用,需要小程序管理员在微信上操作法务协议签署信息后,才可以进行接口调用

# 2:完成接口调用

# 2.1a 商家代码开发

由商家自行使用开发工具进行开发,或前往服务市场购买服务商代开发服务。 具体的开发流程及代码详情可以参照文档目录中自定义版交易组件的部分。

# 注意:这里由开发同学调用接口进行开发,业务同学应开始准备接入后需要的商品材料,包含品牌、类目、资质三个方面,建议提前准备,否则将耽搁直播计划。
# 注意:2.1b 需要接入视频号场景进行带货的商家,可以同时进行商户号的申请,否则将无法正常在视频号中经营。

# 2.2a 申请类目/品牌资质,上传商品,完成商品接口调用

接口调通后,就可以上传并审核商品,审核状态将会通知至商家端。(请务必接入商品审核回调接口

添加商品流程为:

# 注意:商品均需要事先申请类目或品牌资质
# 注意:建议业务同学准备好所有直播计划中需要的商品所有的类目或品牌资质材料,详情可以查看说明建议仔细阅读并映射到自己业务商品中

商品步骤完成后,点击完成,状态会进行改变,商家将会见到下面的界面:


# 2.3a 调试支付校验,完成订单接口调用

由开发同学参照订单相关接口及订单相关开发指引调用接口,成功调用,点击订单接口完成按钮,接入流程状态则会变成已完成,否则将会提醒失败。

支付流程为:

  • (1)按照开发指引修改基础库配置
  • (2)在小程序中调用生成订单接口生成一笔订单
  • (3)完成订单的支付(视频号场景需要调用生成支付参数后完成收银台的拉起,其他场景按照已有业务逻辑进行支付)
  • (4)调用同步订单支付结果接口同步订单的支付结果
# 注意:这里两个接口都需要调用,以同步订单结果为最后确认步骤,视频号场景则以支付成功作为最终确认步骤。
# 注意:基础库拉起收银台接口改造后需要发版才可以生效。
# 注意:完成接口调用后,点击完成,切换状态。

# 2.4a 调试发货接口,完成物流相关接口调用

由开发同学参照物流相关接口调用订单发货接口,成功调用,点击物流接口完成按钮,接入流程状态则会变成已完成,否则将会提醒失败。

# 注意:需要先调用获取快递公司列表接口将正确的快递公司填入发货接口的参数中。

# 2.5a 调试售后接口,完成售后接口调用

开发同学需要调用售后接口将产生售后了的订单售后信息进行流转、同步。完成调用后,点击售后接口完成按钮,接入流程状态则会变成已完成,否则将会提醒失败。

调用同步售后接口同步售后


# 2.6a 需确认小程序已经经过了测试和联调

完成接口对接后,需开发者对小程序的各接口进行测试和联调。这时候不需要调用任何接口。确认后,点击完成按钮,接入流程状态则会变成已完成。


# 2.7a 接口调试完毕,需确认小程序已发布

完成接口对接及商品上传后,提交代码至微信团队审核,审核通过后即可发布,此时支付校验正式生效,这时候不需要调用任何接口,下图为提示,如果依然不可用,请查看发布版本的时间,若发版版本是在接入之前则需要在完成接入后再次将改造了的代码进行发布:


# 至此,自定义版交易组件已经完成了接入,接入之后,就有资格申请并使用微信官方打通的各个场景,在这些场景中,需要按照上面流程中的要求传入商品、生成订单、同步订单、同步售后、同步物流等,否则将视为违规,会收到相应的违规惩罚,严重者将无法使用各类售卖场景。


# 注意:接入完自定义版交易组件后需要将商品完成上传和审核,否则将会耽搁直播计划,因为商品材料的准备及商品的审核需要占用1-10个工作日不等。


# 3:完成场景接入

# 3.1 申请场景接入

前往微信公众平台中,进入“交易组件”>“场景接入”菜单中,查看并选择需要接入的场景,微信官方默认所有场景均接入。

如果已经可以绑定视频号场景,并且可以使用推广员功能,则会看到下图所示界面:

将小程序成员设置为推广员后,该员工可以在自己的视频号里绑定该小程序,并且进行直播带货。


当然,也存在无法使用场景的情况,在这种情况下,界面会显示不可使用的原因,如果有异议,可以点击右上角的客服进行询问,或者点击重新审核按钮。

# 3.2 按照指引接入场景

场景可以接入后,按照不同场景的要求接入。如视频号的接入指引

# 注意:场景的接入需要开发根据场景值,做好判断是否校验的逻辑。

# 4:场景售卖

# 4.1-4.6

用户在需要校验的售卖场景中下单时,商家需要调用上面完成的接口完成订单的生成及状态的同步,同时满足场景的接入要求,否则将无法拉起收银台完成支付。

# 至此,商家完成了整个小程序的接入自定义版交易组件、完成场景接入、完成场景售卖的流程。


# 注意事项

# 1 自定义版交易组件和视频号直播带货的关系

自定义版交易组件是小程序进行视频号直播带货的基础,通过接入自定义版交易组件,并通过视频号直播带货场景的审核后,小程序就拥有了可以绑定视频号并进行直播带货的权限。

# 2 自定义版交易组件如何在视频号直播带货中使用

绑定视频号后,视频号带货列表只能拉取到通过自定义版交易组件上传并通过审核的商品,用户在视频号场景下单的时候,小程序需要调用交易组件的下单接口,按照要求完成用户的支付购买,支付购买后,需要按照要求更新物流及售后情况,任何在直播间产生的订单都属于直播订单。

# 3 视频号直播中下单了非上传的商品的处理方式

使用订单接口将订单中的商品的必传项按照要求做实时上传,按照自定义版交易组件的下单流程进行下单并校验,通过后才可以完成支付,在此之间,商品不需要提前进行审核。

# 4 分场景审核具体的含义

用户只需要上传该场景中使用的商品,并且在该场景中下单时按照自定义版交易组件的要求进行下单即可。

# 5 售后以及物流接口、订单同步接口不能分期对接

因为所有自定义组件产生的订单都会展示在“发现”>“小程序”>“订单中心”,以及“直播间”>“商品列表”>“订单”入口中进行展示,为保证用户体验的一致性,该接口需要同步接入。

# 6 商品、订单等的测试

商品的上传,订单的生成等不依赖环境,由开发者自行决定,可以在正式环境中上传、生成,也可以在测试环境中上传、生成。通过商品、订单等的拉取接口可以看到自己的商品和订单内容。 视频号直播带货的测试需要在正式环境中进行测试,建议在用户量较少的时候,以白名单的直播方式进行测试。

# 7 用户通过加购、复购等方式进行购买行为的处理方式

组件只会在要求校验的场景中对订单进行校验,不区分购买/业务逻辑,即无论是什么样的结算方式,只要不是限定的购买场景,都不需要校验订单。

# 8 分享员和推广员的定义和用法有什么区别

·推广员是小程序设置的可绑定该小程序并售卖其商品的角色,一个小程序最多设置1000个推广员,推广员在一年之内只能被绑定和解绑2次,点击查看具体规则,视频号成交订单将会被记录,小程序可为其分佣,点击查看成交记录的获取

·分享员是小程序设置的可分享指定视频号(已绑定该小程序)下的直播间的角色,一个小程序最多设置10000个分享员,一个分享员最多绑定5个小程序,且绑定到解除绑定时间间隔需超过30天,点击查看具体规则,通过分享后成交的订单将会被记录,小程序可为其分佣,点击查看成交记录的获取