以下未更新完成。请勿使用。
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:不会同步。微信那边申请退款,我们是没有接入的,所以不会同步,要进入微信商城申请退款才行.