想要在视频号中拥有交易购物能力,必须接入交易组件,目前包含标准版交易组件和自定义版交易组件两种接入方案,以下是微信给出的对比及适用场景。
因为有赞已经为商家小程序提供了完善的电商能力,所以自定义交易组件的方案更适合有赞商家小程序来对接微信视频号。
本文主要分享自定义交易组件开通的流程以及基于有赞场景去接入的时候遇到的一些坑,希望能帮助到大家!~
一、总流程
二 、开通微信小程序
这个不必多说,但需要注意的是
1、必须是一个非个人主体的小程序
2、小程序类目需要符合下图要求
三、开通微信支付
后续的订单创建、同步会拉起微信的收银台完成支付,所以需要小程序开通微信支付的能力
四、检查是否已经开通标准版交易组件
标准版和自定义版交易组件是二选一的,所以需要先检查是否开通了标准版交易组件
如果已经开通标准版但没有完成开店任务的话还是可以在微信后台取消使用的;
但如果连开店任务也完成的话,需要先注销(目前微信还没有开放注销功能),如果是有赞的商家的话可以联系有赞客服协助处理
五、授权自定义交易组件权限
因为有赞是微信小程序的三方开发服务商,所以需要商家授权自定义交易组件权限,当然如果非服务商开发的话不用关心。
六、申请接入
微信接口地址:点击跳转
http请求方式:POST
https://api.weixin.qq.com/shop/register/apply?access_token=xxxxxxxxx
只需要获取到access_token后请求这个接口即可,接口是同步返回的(历史上是有异步的版本的,这块如果很早接触但没有在维护过的同学要注意了),这个接口请求失败的话可能是以下原因:
- access_token过期
- 小程序类目不符合
- 已经开通了标准版交易组件
七、完成商品接口调试
7.1 同步商品类目至微信审核
你同步商品的三级类目id以及该类目在微信这边是否要求上传相应的类目资质,需要通过获取微信全量三级类目接口来查询
微信接口地址:点击跳转
http请求方式:POST
https://api.weixin.qq.com/shop/cat/get?access_token=xxxxxxxxx
根据回参中的
qualification_type 类目资质类型
product_qualification_type 商品资质类型
来判断资质是否需要上传
根据回参中的
qualification 类目资质
product_qualification 商品资质
来查询需要上传资质
将回参中的third_cat_id记录,后续同步商品时会用
需要同步的话,就要调用上传类目资质接口,这是个异步接口,审核结果通过需要通过事件回调获取
微信接口地址:点击跳转
http请求方式:POST
https://api.weixin.qq.com/shop/audit/audit_category?access_token=xxxxxxxxx
这块资质图片的字段建议先通过上传图片接口换取media_id来传入
7.2 同步品牌至微信审核
如果你的同步的商品是一个品牌商品,那么在同步商品之前需要先同步品牌信息至微信审核,在审核通过的回调信息中获取到brand_id,之后同步商品时传入
微信接口地址:点击跳转
http请求方式:POST
https://api.weixin.qq.com/shop/audit/audit_brand?access_token=xxxxxxxxx
同样的,这块品牌的一些证照图片的字段建议先通过上传图片接口换取media_id来传入
这里导致审核失败的几个原因:
- 上传证照的图片有问题,譬如有水印、大小超过2M、图片不能正常显示等
- 证照过期
7.3 同步商品至微信审核
现在就可以将调用同步商品接口完成商品同步了,也是一个异步接口,需要等审核回调
微信接口地址:点击跳转
http请求方式:POST
https://api.weixin.qq.com/shop/spu/add?access_token=xxxxxxxxx
这里的tips引用下微信文档上的
注意:
third_cat_id
请根据获取类目接口拿到,并确定其qualification_type
类目资质是否为必填,若为必填,那么要先调类目资质审核接口进行该third_cat_id
的资质审核;
qualification_pics
请根据获取类目接口中对应third_cat_id
的product_qualification_type
为依据,若为必填,那么该字段需要加上该商品的资质图片;
若需要上传某品牌商品,需要按照微信小商店开通规则开通对应品牌使用权限。微信小商店品牌开通规则:点击跳转,若无品牌可指定无品牌(无品牌brand_id: 2100000000
)。
库存字段stock_num
注意如果是0则无法在视频号直播上架该商品。
部分特殊品类商品标题需要按照规范上传,请仔细阅读,避免审核不通过。商品标题规则:点击跳转。
商品详情字段desc_info.desc
desc_info.imgs
虽然非必填,但一些特殊品类仍然需要上传商品详情,请仔细阅读,避免审核不通过。商品详情规则:点击跳转。
这里应该是有赞场景下去开通自定义交易组件卡点比较严重的一环了,因为有赞的商家基数较大,商品种类较多,所以让商家自己同步一个商品至微信的话很容易被微信审核拒掉。有赞这边给到的一个方案是商家在开通自定义交易组件时,系统会帮商家创建一个简单的测试商品,因为这个商品无类目、无品牌且经验证100%通过商品审核,所以这一环的卡点也就能够被顺利疏通。
八、完成订单接口调试
商品同步好后,需要对这个商品用微信支付完成一次交易,并将订单同步至微信
8.1 创建、同步订单
因为自定义交易组件历史版本的原因,目前存在两套创建订单并同步至微信的方案
- 需要后端调用创建订单的微信api获取到ticket,然后小程序获取并通过ticket调用wx.requestPayment来拉起微信收银台(可能会废弃)
- 小程序直接将订单信息通过wx.requestOrderPayment同步给微信,并拉起微信收银台
微信这边推荐使用第二套方案
8.2 支付校验
1、订单全量同步
如果选择订单全量同步到微信的话,那就不需要支付校验。
2、场景校验后同步
使用scene/check方法先去判断是否为视频号场景(这块后续可能会拓展,交易组件应该还会支持视频号以外的场景),是的话再去同步订单至微信。
这里建议在自定义交易组件接口调试过程中可以全量同步,但后续正常业务下单流程还是通过scene/check方式。因为如果你的小程序商城还支持其他支付方式的话,全量同步订单的话就会有坑,原因是无论你选择哪种创建、同步订单的方式都需要唤起微信支付,这样在原本能支持多种支付方式的场景下只能使用微信支付。
8.3 发布小程序
因为创建、同步订单和支付校验有一些小程序的改动,所以小程序还是需要发布版本的。仅是开通流程的话走微信开发者工具也ok。
8.4 支付同步
微信接口地址:点击跳转
http请求方式:POST
https://api.weixin.qq.com/shop/order/pay?access_token=xxxxxxxxx
创建订单并支付成功后调用支付同步接口,就会将订单状态流转待发货
九、完成物流接口调试
9.1 订单发货
微信接口地址:点击跳转
http请求方式:POST
https://api.weixin.qq.com/shop/delivery/send?access_token=xxxxxxxxx
9.2 订单收货
微信接口地址:点击跳转
http请求方式:POST
https://api.weixin.qq.com/shop/delivery/recieve?access_token=xxxxxxxxx
十、完成售后接口调试
10.1 创建售后
微信接口地址:点击跳转
http请求方式:POST
https://api.weixin.qq.com/shop/aftersale/add?access_token=xxxxxxxxx
10.2 更新售后
微信接口地址:点击跳转
http请求方式:POST
https://api.weixin.qq.com/shop/aftersale/update?access_token=xxxxxxxxx
物流、售后接口的调试,如果只是开通流程的话,建议直接后端自动调用完成,可以减少卡点,帮助快速开通。
十一、完成接入任务
11.1 获取接入状态
微信接口地址:点击跳转
http请求方式:POST
https://api.weixin.qq.com/shop/register/finish_access_info?access_token=xxxxxxxxx
回参中的access_info内
spu_audit_success 在商品接口调试成功后会被置为1
pay_order_success 在订单接口调试成功后会被置为1
send_delivery_success 在物流接口调试成功后会被置为1
add_aftersale_success 在售后接口调试成功后会被置为1
11.2 完成所有接入任务
微信接口地址:点击跳转
http请求方式:POST
https://api.weixin.qq.com/shop/register/finish_access_info?access_token=xxxxxxxxx
这个接口可以在上面获取接入状态接口返回的spu_audit_success、pay_order_success、send_delivery_success、add_aftersale_success的字段都为1时一次性调用完成所有。
当下面的任务都被完成后,自定义交易组件就已经完成接入了
6:完成spu接口,7:完成订单接口,8:完成物流接口,9:完成售后接口,10:测试完成,11:发版完成
十二、自定义交易组件接入视频号场景
微信接口地址:点击跳转
http请求方式:POST
https://api.weixin.qq.com/shop/register/finish_access_info?access_token=xxxxxxxxx
只需要调用场景申请接口来申请视频号场景,然后等待微信申请成功就可以完成自定义交易组件接入视频号了
十三、微信后台添加视频号推广员
需要去微信后台添加一个视频号为推广员,然后就可以在这个视频号关联到已经开通自定义交易组件的小程序,关联后就可以上架已经商品同步接口调用通过的商品了。