小程序接入视频号 自定义交易组件的接入

视频号接入条件

1、完成自定义组件的接入/完成标准版组件的接入；

2、完成视频号场景所需要的商户号、接口的申请和接入；

3、小程序中需要具备基本的客服和售后能力，且需要通过更新商家信息接口完成客服的更新，才可以正常上传商品。

视频号接入后功能介绍

1、可在视频号场景实现商品展示和带货等功能

2、支持更多直播营销玩法（券、秒杀、预售等）

3、支持小程序客服组件，商家能更方便收到用户的客服咨询

4、订单中心显示更完善的订单信息，用户可自行查看订单状态

5、支持用户在视频号订单中心继续付款、发起售后

自定义组件接入

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

一．自定义组件接入

第一步

前置流程：接入准备

检查是否已经开通标准版

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

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

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

1.1 申请接入

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

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

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

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

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

a. 商品相关接口：商品添加、商品修改、商品上架、商品下架、商品更新等

b. 订单相关接口：生成订单、获取支付参数、订单的状态同步、订单获取等

c. 资金相关接口：管理资金、查看详情、发起提现、修改账户等

d. 资质相关接口：品牌资质上传、类目资质上传、商品资质上传等

e. 物流及售后相关接口：物流信息同步、售后单生成、售后情况同步等

f. 事件回调接口：用以接收商品审核，类目审核，品牌审核结果同步等

注意：所有接口都需要接入及联调，避免影响正常经营

注意：如果通过接口调用，需要小程序管理员在微信上操作法务协议签署信息后，才可以进行接口调用

2：完成接口调用

2.1a 商家代码开发

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

注意：这里由开发同学调用接口进行开发，业务同学应开始准备接入后需要的商品材料，包含品牌、类目、资质三个方面，建议提前准备，否则将耽搁直播计划。

注意：2.1b 需要接入视频号场景进行带货的商家，可以同时进行商户号的申请，否则将无法正常在视频号中经营。

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

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

添加商品流程为：

（1）获取类目详情，与自己的商品类目相匹配

（2）查看类目是否需要行业资质如果需要，请上传相关资质

（3）上传相关类目资质获得类目的使用权限

（4）如果商品有品牌，上传品牌信息获得品牌的使用权限

（5）调用添加商品接口将商品进行上传

注意：商品均需要事先申请类目或品牌资质

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

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

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

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

支付流程为：

（1）按照开发指引修改基础库配置

（2）在小程序中调用生成订单接口生成一笔订单

（3）完成订单的支付（视频号场景需要调用生成支付参数后完成收银台的拉起，其他场景按照已有业务逻辑进行支付）

（4）调用同步订单支付结果接口同步订单的支付结果

注意：这里两个接口都需要调用，以同步订单结果为最后确认步骤，视频号场景则以支付成功作为最终确认步骤。

注意：基础库拉起收银台接口改造后需要发版才可以生效。

注意：完成接口调用后，点击完成，切换状态。

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

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

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

2.5a 调试售后接口，完成售后接口调用

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

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

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

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

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

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

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

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

已经完成自定义组件接入的商家需要注意，改动项如下：

1、需申请一个业务使用的商户号：参考2.1b，可在“小程序后台>交易组件>视频号场景“中直接申请（预期3月底上线），也可调用进件接口完成申请。

2、订单接口需更新：参考2.3a，要调用微信侧生成支付参数的接口生成在视频号场景中拉起收银台所需要的参数，否则在视频号中无法完成支付。（建议：检查场景值是否在支付校验范围内——>若为视频号场景——>调用接口生成订单、生成支付参数——>使用参数拉起收银台——>完成支付）

3、售后接口更新：参考2.5a，所有售后相关操作需要通过接口/回调进行同步。

1）用户在商家小程序发起视频号场景订单的售后，需要调用生成售后单接口生成一笔售后，并且调用售后相关接口操作售后状态；

2）用户在视频号订单发起的售后，需要通过回调收到售后情况，并调用售后相关接口操作售后状态。

注意：通过 API 进行的申请接入，需要小程序管理员前往消息通知中查看模板消息，签署法务协议，签署成功后，才可以继续进行接口的调试。

第二步

2：完成接口调用

2.1a 商家代码开发

2.1b 申请商户号

视频号场景需要申请商户号作为场景经营使用的资金账户。

点击申请按钮，进入到申请流程中，按照流程填写申请内容，即可完成商户号申请，如下图所示：

申请商户号时，也可以通过调用进件接口接口来完成申请，申请的状态可以通过状态查询接口进行查询。

申请商户号后，可以通过接口对商户号进行管理，如：

1、想要查看商户号的经营流水时，调用获取资金流水列表

2、需要单独查看某一笔流水时，调用获取资金流水详情

3、查看商户号的余额时，调用查询商户余额

4、需要提现时，调用发起提现

5、查询提现记录时，调用获取提现记录详情

6、修改商户号结算提现商户号时，调用修改结算账户

7、查询当前商户号结算商户号时，调用查询结算账户

8、批量获取提现记录时，调用获取提现记录列表

...

注意：商户号的申请可以和商品接口同步进行，相互之间可以并行。

2.2a 商家上传商品

注意：需要通过更新商家信息接口完成客服的更新，才可以正常上传商品。

2.3a 调试订单接口

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

支付流程为：

（1）按照开发指引修改基础库配置

（2）在小程序中调用生成订单接口生成一笔订单

（3）调用生成支付参数

（4）使用wx.requestOrderPayment，拉起收银台，让用户完成付款

（5）在订单支付成功回调中获得订单的支付结果

注意：以支付成功作为最终确认步骤。

注意：基础库拉起收银台接口改造后需要发版才可以生效。

2.4a 商家上传商品

注意：需要通过更新商家信息接口完成客服的更新，才可以正常上传商品。

2.5a 调试售后接口，完成售后接口调用

二．前往视频号卖货

关联小程序

关联条件说明：已经完成组件接入（自定义组件完成视频号场景接入），且满足以下其中一项即可将当前视频号与小程序关联

（1）视频号和小程序的的管理员一致

（2）视频号的管理员为小程序的推广者（可在小程序后台>交易组件>视频号场景>推广员模块设置）

三．设置视频号推广员和分享员

小程序设置推广员后，该推广员可以在自己的视频号中绑定小程序，达到多个员工/门店绑定视频号的需求。

小程序设置分享员后，该分享员可以分享直播间给用户，达到为直播带来更多流量的需求。

设置指引：

（1）小程序接入交易组件后，前往微信公众平台，打开“交易组件>场景接入>视频号推广/分享”

（2）点击“推广员/分享员”输入微信号，点击搜索，在搜索结果中，勾选该微信

（3）点击“确认”即可

注意：推广员每半年只可以切换绑定了的小程序一次，部分电商平台小程序暂时不支持使用推广员功能。

四．管理商户号及提现等

自行配置即可，步骤略

注：该文档是自定义组件的接入的文档，其它方式接入可另行查看其它文章