注意：自定义交易组件【升级版】，即新接口适配（必须走新商户号）于2022年4月29号下午约15:00发布上线，站点注意先更新最新，上传最新小程序代码（版本大于v1.1.170），完成了小程序代码的发布和上线! 再按下面流程开通自定义交易组件！

品牌类交易组件资质报备提醒各位视频号橱窗商家：为进一步规范视频号橱窗商家的经营行为，推动平台生态健康发展，2022年11月30日后，非品牌类小程序交易组件将不能在视频号场景经营。如你所经营的小程序交易组件为品牌类组件，可在11月21日前进行资质报备，经审核通过后方可继续在视频号场景经营。轻触【了解详情】，查看资质报备条件与方式。
链接内容：https://support.weixin.qq.com/cgi-bin/mmsupportacctnodeweb-bin/pages/oKqYAys6N2y37tHG如需要使用视频号功能，可以看视频号小店插件（操作流程具体查看对应教程）

一、功能概述

商城接入自定义版交易组件，商家可按流程接入自定义交易组件，实现视频号和微信小程序的打通，助力商家在微信视频号卖货。

二、实现场景

实现功能一：

用户进入视频号主页时，可直接看到商品橱窗商品，点击商品跳转小程序商城，使用微信支付下单购买，订单同步到微信端。

页面展示：

实现功能二：

通过微信视频号开启直播，可在商品商城橱窗挑选需要带货商品，用户观看视频号直播，点击商品，跳转小程序商城，用微信支付下单购买，订单同步到微信端。

页面展示：

三、登录商城后台授权安装启用“自定义交易组件”

安装路径：总后台 — 安装应用 — 搜索“自定义交易组件”并安装

启用路径：总后台 — 系统 — 插件管理 –启用“自定义交易组件”插件

四、小程序官方后台mp.weixin.qq.com配置ip白名单、消息推送、开通自定义交易组件

需要注意：1、必须是一个非个人主体的小程序2、小程序类目需要符合下图要求。

https://developers.weixin.qq.com/doc/ministore/minishopspecification/leimuzizhi/qiyeleimu.html

（一）配置ip白名单

因为视频号只能用二级商户订单，必须配置白名单。

路径：开发 — 开发管理 — 开发设置 — 开发者ID — 添加ip白名单（ip地址为您的服务器ip），需要小程序管理员扫码确认添加。

站点没做集群即一台服务器情况下，填写一个服务器ip就行，如下截图

站点做集群，填写全部ip，如下截图：

（二）启用和配置消息推送

配置二级订单状态回调，须启用和配置小程序消息推送。

1、路径：开发 — 开发管理 — 开发设置 — 消息推送

2、下一步，点击启用（需要小程序管理员扫码确认），填写URL、Token、 EncodingAESKey

消息加密方式：选择“明文”

数据格式：选择“XML”

3、URL、Token、 EncodingAESKey如何填写？

进入商城后台 — 应用 — 公众号 — 复制服务器地址（URL）、令牌（Token）、消息加密密钥（EncodingAESKey）粘贴到小程序的消息推送处。（必须启用公众号，若有接入公众号，启用状态务必是“已接入”）

（三）开通自定义交易组件

1、开通路径

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

微信官方暂时不支持标准交易组件转自定义交易组件，如果之前开错了，只能暂时放弃；也不能主动取消，否则无法再次开通，后续可开通小程序会有站内通知。

2、申请开通

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

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

3、组件接入

（1）商户号申请：场景经营所需商户号的申请，可以查看小程序使用该商户号产生的交易金额、流水，申请、管理及操作。

开通指引如下

① 点击去开通，申请商户号有三个步骤，先填写“步骤一基础信息”，上传营业执照法人身份证信息。

② 补充资料为选填，不用填，直接跳过。

③ 提交后，需要审核，在“基础信息”审核中期间，进行下一步“步骤二验证账户”

账户验证分两种，选择其中一种方式验证。

验证方式一: 法人验证，在规定时间内使用法人微信号扫一扫进行账户验证。

验证方式二：汇款验证，即公账汇款，在规定时间内使用用户名为“xxxxx公司”的银行账户汇款至指定账户。

验证后点击下方的“我知道了”，刷新页面查看最新结果。预计2个工作日内完成审核。

④ 通过后，进行下一步“步骤三签约开通协议”

小程序管理员或小程序开发者扫码确认签署，手机微信扫码确认流程如下

⑤ 商户号开通后效果如下

（2）商品接口调用：商品添加、商品修改、商品上架、商品下架、商品更新等

① 路径：在商城后台 — 自定义交易组件 — 微信商品列表 — 新增（上传商品）

② 选择商品分类，该分类为微信官方的商品分类，与商城添加的商品分类无关，部分需要审核才能开启的分类会被隐藏，点击更新分类可以从微信官方同步分类数据到本地。（目前只支持选择商城平台自营商品，其他插件商品暂不支持，后续将逐步支持）

③ 选择商品，一次最多选择10个商品，如果该分类需要商品资质证明，在商品列表会出现商品资质按钮（商品资质图片默认取上一次审核时提及的图片），点击后选择图片并上传。

④ 点击提交，系统会自动获取商品数据并且提交审核。

⑤ 提交完毕后会跳转到审核列表。

（3）订单接口调用

首先在商城后台自定义交易组件绑定订单调试开通。

类型：普通订单、二级商户订单。（2种类型都要绑定，分开下单绑定对应单号，视频号只能用二级商户订单，绑定没有先后顺序，只要都有绑定订单就行）

接入测试订单流程：先在小程序下单微信审核商品（仅提交订单不要付款），绑定下单未付款的订单号，后台进行绑定，订单进行发货收货申请退款。【微信审核商品讲解可看上面（2）商品接口调用说明】

流程说明：该功能仅供接入流程测试使用，其他一般订单请勿使用

（1）进入小程序商城，选择已通过审核的商品，并且下单，并且不要支付.
（2）将订单号复制到输入框，并且点击绑定，如下图所示.

（3）普通订单关联后在小程序进行微信支付后，在后台订单列表进行发货，收货完成，退款关闭等操作。关闭退款操作可直接在后台点击“退款并关闭订单”，会员也可以在前端申请退款。

后台订单列表如果没显示“退款并关闭订单”，检查后台系统–交易设置–退款设置要开启退款按钮，订单完成后多少天内允许退款，不能为空为0.

注意：通过后台点“退款并关闭订单”，若提示“未上传完整的微信支付证书，请到系统设置–支付方式中上传!”

处理方法：重新上传小程序微信支付CERT证书文件、KEY密钥文件，路径如下

（4）二级商户订单关联后需要在小程序进行微信支付后，该笔订单支付方式显示“微信支付（视频号）”，在后台订单列表进行发货，收货完成，申请退款关闭订单等操作。二级商户订单的售后退款，直接通过商城后台操作，说明如下图所示.

（4）物流接口调用

对上述关联绑定的订单，在后台点击确认发货(可以填写真实快递单号和公司，也可以随便填写)，确认收货。

（5）售后接口调用

如上订单接口调用的步骤，测试绑定关联的订单有进行退款操作即可.

(3)(4)(5)接口调用步骤完成，便可在小程序后台–交易组件–组件接入，点击完成.

注意要完成，否则提示“检测到你未完成此项步骤，请确认后重试”，如下图所示.

4、发布小程序

自定义交易组件新接口适配功能是2022年4月29号下午约15:00发布上线的，站点注意更新最新，上传最新小程序代码，完成了小程序代码的发布和上线!

5、完成组件接入

（四）申请场景接入

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

1、视频号

（1）视频号推广：开通需要微信审核，一般2个工作日可以申请下来，具体以微信审核时间为准。添加一个视频号为推广员，然后就可以在这个视频号关联到已经开通自定义交易组件的小程序，关联后就可以上架已经商品同步接口调用通过的商品了。

（2）直播间分享员：开通无需审核。

直播间分享员说明 >>https://developers.weixin.qq.com/community/business/doc/000804f4248538558facd4fff5f40d

2、订单中心

开通能力后：可增强订单曝光和小程序留存，在「微信」-「发现」-「小程序」-「我的订单」看到订单同时收到订单变更的消息. 查看指引>>https://docs.qq.com/doc/DUnlGcXVWREREelpV

五、商城后台 — 自定义交易组件配置

（一）基础设置（接入组件）

程序会判断当前小程序是否已经接入自定义交易组件，如果未接入，在接入状态处会有“申请接入”按钮，点击会申请开通自定义交易组件。

已接入状态如下

1、订单接入

如上面 “小程序官方后台 — （三）开通自定义交易组件 –3、组件接入 — 订单接口调用” 说明.

2、售后地址

用于流程走不通时让微信返回报错信息。

3、商户信息

（二）类目审核列表（同步类目至微信审核）

微信那边个别类目需要审核，这边可在类目审核列表–点击申请

选择商品分类根绝所需资质证书提示上传资质材料和营业执照

提交后，等待审核可查看类目名称、审核单号、营业执照和资质材料

审核通过了显示如下

（三）同步商品至微信审核

1、微信商品列表—新增（上传商品）

（1）点击微信商品列表

（2）点击右上角新增

（3）选择商品分类，该分类为微信官方的商品分类，与商城商品分类无关，部分需要审核才能开启的分类会被隐藏，点击更新分类可以从微信官方同步分类数据到本地。（目前只支持选择商城自营商品，其他商品类型将逐步支持）

（4）选择分类后，如果该分类需要提交商品资质证明，会出现提示。

（5）选择商品，一次最多选择10个商品，如果该分类需要商品资质证明，在商品列表会出现商品资质按钮（商品资质图片默认取上一次审核时提及的图片），点击后选择图片并上传。

（6）点击提交，系统会自动获取商品数据并且提交审核。

（7）提交完毕后会跳转到审核列表。

2、商品审核列表

（1）商品审核列表会显示提交的审核记录和审核状态等信息。

① 点击查看数据：可以看到提交审核时上传的数据信息：名称，分类，图片，审核状态，时间，规格。

（审核一般数分钟到十几小时都有，商品审核会有审核结果回调，但是回调只有一次请求容易漏掉，所以可以直接点击同步按钮更新所有未完成的审核。）

② 点击取消审核:会取消当前正在进行中的审核。

③ 点击重新提交：会进入该商品的提交页面，提交的商品数据以当前商城数据为准。（审核期间，线上商品信息依然是审核前的状态）

（四）线上商品列表

1.同步：获取微信端数据，更新本地的商品数据

2.新增/上传商品：跳转到商品上传页面，如果是上传商品，会默认带上选择的商品和分类

3.查看数据：查看商品数据详情，此处的商品数据会实时从微信端获取最新数据并且更新当前商品

4.审核详情：查看该商品最新的一次审核的情况

5.删除商品：删除微信端的该商品，同时删除该商品的审核记录。

6.商品状态：

①初始：新的商品刚刚提交审核，并且还没有通过审核或者审核被驳回

②自主下架：通过审核后的商品自行下架

③上架：通过审核后的商品上架中

④风控/违规下架：被微信端下架

7.点击商品名可以跳转到商品编辑页面

（五）特别注意

①要将订单同步到微信，需要上传规格，如果在商城规格与线上商品规格不一致的情况下，会出现同步失败的问题。所以进行视频号直播带货前请确认微信端与本地商品规格信息一致。

②从微信视频号进入小程序时，只能购买已经同步到微信端的商品，其他商品如果下单后使用微信支付，会出现下单/调起支付失败的问题。出现这种情况需要重新进入小程序才可以正常购买其他商品

③只有在视频号进入小程序后下单支付并且使用微信支付的订单，才会同步到微信端。如果使用其他支付方式、长时间未支付或在其他端支付，可能导致同步失败。

六、日常问题

Q1、小程序开通了交易组件的商户号，是否要把商户号信息填到商城小程序微信支付里？

A1：不需要，小程序还是按照原先配置的支付信息。视频号场景需要申请商户号作为场景经营使用的资金账户，仅用于视频号商品订单微信支付资金进入该账户，可以通过这查看流水详情。

Q2、新版交易组件需要重新申请商户号吗？是否可以使用原有商户号？

A2：不可以，新版交易组件必须要申请开通场景专用商户号

Q3、新版场景专用商户号费率是多少，是否有优惠，结算周期是多久？

A3：商户号费率为0.6%，无费率优惠，结算周期为7+7日，即用户收货后7天后结算。

Q4、视频号橱窗管理获取不到对应小程序

A4：1、检查是否开通视频号场景；2、检查是否绑定了推广员（非小程序超管需要绑定推广员）

Q5、绑定普通订单、二级商户订单，有先后顺序的吗，可以先绑定二级商户订单吗？

A5：可以，没有先后顺序，2种类型有绑定即可.

Q6、怎么看测试订单有没有绑定成功呢？

A6：先进小程序商城拍下已审核商品，注意不要付款，后台绑定订单提示绑定成功后，再在进小程序商城完成微信支付，订单将展示在「微信」-「发现」-「小程序」-「我的订单」,如下图

Q7、绑定二级商户订单，进入小程序完成支付，怎么提示“获取支付参数失败，错误码40164:invalid ip…”

A7：小程序ip白名单没配置，可登录小程序平台mp.weixin.qq.com — 开发 — 开发管理 — 开发设置 — 开发者ID — 添加ip白名单（ip地址为您的服务器ip），添加后，再进入支付便可正常。

Q8、二级商户订单前端微信支付提示提示“获取支付参数失败，错误码1010043:当前订单状态不允许…”？

A8：一般这情况原因是小程序没配置ip白名单，也没启用配置消息推送。启用配置说明看上面“第四大点的第（二）点：启用和配置消息推送”。配置后重新进入支付即可。

Q9、没接入公众号（服务号），只接入小程序，还能配置消息推送吗？

A9：可以。依旧是在商城后台 — 应用 — 公众号 — 复制服务器地址（URL）、令牌（Token）、消息加密密钥（EncodingAESKey）粘贴到小程序的消息推送处。

Q10、通过视频号转发购买商品，是否能锁客？

A10：不是通过商城里分享的都无法锁客。

Q11、添加视频号推广提示“请检查视频号主体是否与本小程序一致”

A11：小程序主体是企业认证，视频号也必须是企业认证，需要同主体。

Q12、只要添加成推广员，是不是代表推广员这个账号已经和小程序完成了绑定，直接在直播的商品带货中添加小程序的商品即可？还是说需要额外的什么流程或者业务？

A12：是的，没有其他额外流程。

Q13、小程序自定义交易组件一天能添加几个视频号推广员？

A13：避免被人滥用，目前只能一天主动搜索10次。

Q14、接入测试订单提示商品规格异常。

A14：修改过商品规格后没有重新上传商品到微信，重新上传试试看.

Q15、自定义交易组件“升级版”跟升级前的自定义交易组件有什么区别，哪些接口需要升级?

A15：

新支付接口，必须走新商户号。
取消订单，小程序(小程序内以及发现-小程序我的订单)和视频号双向可取消，之前只可以在小程序上取消，然后同步给视频号状态。
申请退款，小程序和视频号双向可申请退款。
申请退货退款,小程序和视频号双向可申请退货退款，之前只有小程序上操作。
未付款订单，小程序和视频号可在各自订单中心重新支付，同步状态。
确认收货，小程序和视频号双向可确认收货。
同步发货状态接口更新。

Q16、后台点击自定义交易组件，提示获取access_token失败？

A16：小程序没配置白名单，加上就可以了。

Q17：视频号橱窗商品订单，在微信端–发现–小程序订单里申请退款，商城有同步退款的吗

A17：不会同步。微信那边申请退款，我们是没有接入的，所以不会同步，要进入微信商城申请退款才行.