注意：自定义交易组件【升级版】，即新接口适配（必须走新商户号）于2022年4月29号下午约15:00发布上线，站点注意更新最新，上传最新小程序代码，完成了小程序代码的发布和上线!
一、功能概述
商城接入自定义版交易组件，商家可按流程接入自定义交易组件，实现视频号和微信小程序的打通，助力商家在微信视频号卖货。
二、实现场景
实现功能一：
用户进入视频号主页时，可直接看到商品橱窗商品，点击商品跳转小程序商城，使用微信支付下单购买，订单同步到微信端。 页面展示：
实现功能二：
通过微信视频号开启直播，可在商品商城橱窗挑选需要带货商品，用户观看视频号直播，点击商品，跳转小程序商城，用微信支付下单购买，订单同步到微信端。 页面展示：
三、登录商城后台授权安装启用“自定义交易组件”
后台 — 系统 — 插件管理 –启用“自定义交易组件”插件
四、小程序官方后台mp.weixin.qq.com配置ip白名单、消息推送、开通自定义交易组件
需要注意：
1、必须是一个非个人主体的小程序
2、小程序类目需要符合下图要求
（一）配置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）普通订单关联后在小程序进行微信支付后，在后台订单列表进行发货，收货完成，退款关闭等操作。关闭退款操作可直接在后台点击“退款并关闭订单”，如下图所示.
注意：通过后台点“退款并关闭订单”，若提示“未上传完整的微信支付证书，请到系统设置–支付方式中上传!” 处理方法：重新上传小程序微信支付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：不会同步。微信那边申请退款，我们是没有接入的，所以不会同步，要进入微信商城申请退款才行.
