# **注意：自定义交易组件**【升级版】，即**新接口适配（必须走新商户号）于2022年4月29号下午约15:00发布上线，站点注意先更新最新，上传最新小程序代码（版本大于v1.1.170），完成了小程序代码的发布和上线! 再按下面流程开通自定义交易组件！** # 一、功能概述 商城接入自定义版交易组件，商家可按流程接入自定义交易组件，实现视频号和微信小程序的打通，助力商家在微信视频号卖货。 # 二、实现场景 ## 实现功能一： 用户进入视频号主页时，可直接看到商品橱窗商品，点击商品跳转小程序商城，使用微信支付下单购买，订单同步到微信端。 页面展示：  ## 实现功能二： 通过微信视频号开启直播，可在商品商城橱窗挑选需要带货商品，用户观看视频号直播，点击商品，跳转小程序商城，用微信支付下单购买，订单同步到微信端。 页面展示：  # 三、登录商城后台授权安装启用“自定义交易组件” 安装路径：总后台 -- 安装应用 -- 搜索“自定义交易组件”并安装 启用路径：总后台 -- 系统 -- 插件管理 --启用“自定义交易组件”插件  # 四、小程序官方后台mp.weixin.qq.com配置ip白名单、消息推送、开通自定义交易组件 需要注意：1、必须是一个非个人主体的小程序2、小程序类目需要符合下图要求。 [https://developers.weixin.qq.com/doc/ministore/minishopspecification/leimuzizhi/qiyeleimu.html](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、开通路径 路径：小程序后台 -- 功能 -- 交易组件 -- 开通自定义版交易组件。若小程序满足自定义版交易组件的接入要求，在[微信公众平台](https://developers.weixin.qq.com/miniprogram/dev/platform-capabilities/business-capabilities/ministore/minishopopencomponent2/mp.weixin.qq.com)登录小程序，则会看到下图所示界面   微信官方暂时不支持标准交易组件转自定义交易组件，如果之前开错了，只能暂时放弃；也不能主动取消，否则无法再次开通，后续可开通小程序会有站内通知。  ### 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](https://developers.weixin.qq.com/community/business/doc/000804f4248538558facd4fff5f40d) ###  ### 2、订单中心 开通能力后：可增强订单曝光和小程序留存，在「微信」-「发现」-「小程序」-「我的订单」看到订单同时收到订单变更的消息.[查看指引>>https://docs.qq.com/doc/DUnlGcXVWREREelpV](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： 1. 新支付接口，必须走新商户号。 2. 取消订单， 小程序(小程序内以及发现-小程序我的订单)和视频号双向可取消，之前只可以在小程序上取消，然后同步给视频号状态。 3. 申请退款，小程序和视频号双向可申请退款。 4. 申请退货退款,小程序和视频号双向可申请退货退款，之前只有小程序上操作。 5. 未付款订单，小程序和视频号 可在各自订单中心重新支付，同步状态。 6. 确认收货，小程序和视频号双向可确认收货。 7. 同步发货状态接口更新。 ### Q16、后台点击自定义交易组件，提示获取access\_token失败？ A16：小程序没配置白名单，加上就可以了。   Q17：视频号橱窗商品订单，在微信端--发现--小程序订单里申请退款，商城有同步退款的吗 A17：不会同步。微信那边申请退款，我们是没有接入的，所以不会同步，要进入微信商城申请退款才行.