注意：自定义交易组件【升级版】，即新接口适配（必须走新商户号）于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种类型都要绑定，分开下单绑定对应单号，视频号只能用二级商户订单，绑定没有先后顺序，只要都有绑定订单就行）   接入测试订单流程：先在小程序下单审核商品（仅提交订单不要付款），绑定下单未付款的订单号。   流程说明：该功能仅供接入流程测试使用，一般订单请勿使用 （1）进入小程序商城，选择已通过审核的商品，并且下单，并且不要支付. （2）将订单号复制到输入框，并且点击绑定，如下图所示.   [图片][图片]   （3）普通订单关联后在小程序进行微信支付后，在后台订单列表进行发货，收货完成，退款关闭等操作。关闭退款操作可直接在后台点击“退款并关闭订单”，如下图所示. [图片]   注意：通过后台点“退款并关闭订单”，若提示“未上传完整的微信支付证书，请到系统设置--支付方式中上传!” 处理方法：重新上传小程序微信支付CERT证书文件、KEY密钥文件，路径如下 [图片][图片]   （4）二级商户订单关联后需要在小程序进行微信支付后，在后台订单列表进行发货，收货完成，售后审核，退款关闭等操作。二级商户订单，可以在微信--视频号--订单--售后退款--进入页面点退款（二级商户订单退款，实际上是模拟前端申请退款）。如下图所示. [图片][图片][图片][图片]   （4）物流接口调用 对上述关联绑定的订单，在后台点击确认发货(可以填写真实快递单号和公司，也可以随便填写)，确认收货。 [图片]     （5）售后接口调用   如上 订单接口调用 的步骤，测试绑定关联的订单有进行退款操作即可. [图片]   (3)(4)(5)接口调用步骤完成，便可在小程序后台--交易组件--组件接入，点击完成. [图片]   注意要完成，否则提示“检测到你未完成此项步骤，请确认后重试”，如下图所示. [图片]   4、发布小程序   自定义交易组件新接口适配功能是2022年4月29号下午约15:00发布上线的，站点注意更新最新，上传最新小程序代码，完成了小程序代码的发布和上线! [图片]     5、完成组件接入 [图片]   （四）申请场景接入   前往小程序微信公众平台中，进入“交易组件”>“场景接入”菜单中，查看并选择需要接入的场景，微信官方默认所有场景均可接入. [图片]   1、视频号   （1）视频号推广：开通需要微信审核，一般2个工作日可以申请下来，具体以微信审核时间为准。添加一个视频号为推广员，然后就可以在这个视频号关联到已经开通自定义交易组件的小程序，关联后就可以上架已经商品同步接口调用通过的商品了。   视频号关联小商店/小程序： https://developers.weixin.qq.com/community/business/doc/000ce0f5014a186f871bf21b459c0d   视频号直播关联小商店/小程序 https://developers.weixin.qq.com/community/business/doc/000ce8f5688b4873a72b2d6c15ac0d   [图片] [图片]   （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：检查是否开通视频号场景；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：修改过商品规格后没有重新上传商品到微信，重新上传试试看. [图片]