以菜虫网络平台（www.wcccwl.com）商城小程序为例： 视频号接入 1.微信公众平台小程序后台交易组件里选择开通自定义交易组件（网址：https://mp.weixin.qq.com/） [图片]   2. 小程序后台高级配置--微信能力--交易组件中添加商品 [图片] 添加商品之后可以在微信公众平台交易组件里调用商品接口可确认完成 [图片]     3. 重新打包小程序打包时勾选微信自定义交易组件（下图为普通打包和超级页面中勾选自定义组件的位置） [图片]   [图片] 4.导入开发者工具里，添加编译模式，进入场景选择一下1177：视频号直播商品 [图片] [图片]   5在新打包的小程序里下一个订单，配送方式要选择商家配送，使用微信支付；商品要选择在后台交易组件中添加的并且审核通过的商品，订单发货之后可以点击订单接口调用完成和物流接口调用完成 [图片]   订单申请一下退款，走一下退款流程，可以点击售后接口调用完成 [图片] 6.场景接入开通根据商家情况添加推广员即可    

一、背景 在7月份，微信小程序上线了跳转视频号直播的功能，我们也在第一时间发布了直播悬浮窗组件，使商家能够更便捷的将用户导流至视频号直播，促进成交。在近期，微信又上线了小程序预约直播功能，更加丰富了小程序与视频号之间的互动，我们也在微页面中新增了相关组件，帮助商家接入该功能。 二、实际效果 1、视频号直播悬浮窗 点击可跳转视频号直播间。该组件无需配置，商家直播时便会在页面上展示。 [图片] 2、视频号直播组件 需要商家在后台微页面配置，只要商家在视频号直播中创建预告，即可出现预约状态，支持用户点击预约 [图片] 点击预约后 [图片] 预约之后，在直播开始时，将会有消息推送提醒用户进直播间： [图片] 若直播已开始，则会展示直播中的状态，点击跳转直播间 [图片][图片] 三、对接微信接口 1、小程序跳转视频号直播间 开发者首先通过wx.getChannelsLiveInfo传入视频号id用于获取视频号直播信息，包括直播id（feedId与nonceId两个参数）与直播状态。其中直播状态含义如下： status=2：直播中，此时返回的feedId与nonceId为当前直播idstatus=3：直播已结束，此时返回的feedId与nonceId为最近一次直播id获取直播信息后，开发者可以通过wx.openChannelsLive打开视频号直播。若当前未在直播，则会跳转到最近一场直播的结束页。该接口使用限制如下：  需要用户触发跳转，若用户未点击小程序页面任意位置，则开发者将无法调用此接口。需要用户确认跳转，在跳转至视频号直播前，将统一增加弹窗，询问是否跳转，用户确认后才可以跳转视频号直播。在调试wx.getChannelsLiveInfo接口时比较麻烦的是需要在真机上测试，在开发者工具上，接口无法正常获取信息，会报告如下错误： {"errMsg":"getChannelsLiveInfo:fail","err_code":"-14"}   当然在真机上也得注意获取的是同一主体的视频号直播信息，否则会报告如下错误： {"errMsg":"getChannelsLiveInfo:fail data unknow error code","err_code":"100008"}   成功获取到视频号直播信息后，就可以调用wx.openChannelsLive进行直播间跳转，可能是为了防止开发者滥用此功能，微信要求必须用户点击小程序页面任意位置才能触发此接口，这句话说的有点模糊，到底是说用户点击后，就可以在任意时间调用此接口，还是每次调用都需要用户点击。在实际测试了之后发现，每次调用都需要用户点击，也就是需要在点击回调事件中调用，并且这里还有一点要注意，不能将调用写在promise或者setTimeout中，如： setTimeout(() => { wx.openChannelsLive() }, 0); Promise.resolve().then(() => { wx.openChannelsLive(); });   这样也会导致接口调用失败。 四、小程序内发起预约视频号直播 预约也是分两步走 开发者首先通过wx.getChannelsLiveNoticeInfo传入视频号id用于获取视频号直播预告id（noticeId），若当前没有可预约的直播预告，将返回失败。获取直播预告信息后，开发者可以通过wx.reserveChannelsLive唤起预约弹窗，用户可以进行预约操作。成功唤起弹窗即为接口调用成功，通过state可以获取用户具体操作行为。获取预告信息会给到如下信息： [图片] 其中noticeId是用于后续预约预告用的，没什么可说的，比较让人疑惑的是status和reservable字段，你可能会将status理解成目前的预告状态，reservable理解成用户是否已预约，没毛病，笔者刚开始也是那么理解的，但真实调用后发现status只会存在0这种状态，如果预告被取消了或者已用，那直接就走到fail回调里面了。而reservable也不是是否已预约的意思，不管用户是否预约，该字段都是返回true。 所以，status和reservable字段目前给不到更多有价值的信息（后期可能会调整），若你想得知用户是否已预约，只能自己写接口去记录了。 获取直播预告信息后，开发者可以通过wx.reserveChannelsLive唤起预约弹窗，不同于跳转直播间，预约弹窗可随时唤起，不需要用户有点击操作，且支持在异步回调中调用。 [图片] 预约弹窗唤起后，根据用户的行为，会在success回调中返回相应的state值： [图片] 这里特别要说明的是，如果是正在直播中的状态，wx.reserveChannelsLive不再会唤起预约弹窗，而是直接唤起跳转直播弹窗，与wx.openChannelsLive的效果类似： [图片] 关于视频号预告，还有一点冷知识，当实际时间到达预告时间时，预告不会立即消失，而是会再保持一个小时，若一个小时后还未开始直播，预告才会被移除，并且在移除之前，预约相关的接口都可以正常调用。 五、总结 本文主要介绍了小程序对于视频号直播预约、跳转的支持，以及实际对接过程中遇到的一些问题，若想了解如何在视频号直播卖货可移步至https://help.youzan.com/displaylist/detail_4_4-2-54639 六、一些期待 目前视频号直播的功能都必须在同一主体下才能使用，希望微信能够早日放开这一限制。给到用户与开发者的直播数据过少，希望微信能够开放更多的直播数据，帮助用户分析直播效果，提升直播质量。

想要在视频号中拥有交易购物能力，必须接入交易组件，目前包含标准版交易组件和自定义版交易组件两种接入方案，以下是微信给出的对比及适用场景。 [图片] 因为有赞已经为商家小程序提供了完善的电商能力，所以自定义交易组件的方案更适合有赞商家小程序来对接微信视频号。 本文主要分享自定义交易组件开通的流程以及基于有赞场景去接入的时候遇到的一些坑，希望能帮助到大家！~ 一、总流程[图片] 二 、开通微信小程序 这个不必多说，但需要注意的是 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 只需要调用场景申请接口来申请视频号场景，然后等待微信申请成功就可以完成自定义交易组件接入视频号了   十三、微信后台添加视频号推广员需要去微信后台添加一个视频号为推广员，然后就可以在这个视频号关联到已经开通自定义交易组件的小程序，关联后就可以上架已经商品同步接口调用通过的商品了。 [图片] [图片]

公告更新时间：2021年04月15日考虑到近期开发者对小程序登录、用户信息相关接口调整的相关反馈，为优化开发者调整接口的体验，回收wx.getUserInfo接口可获取用户授权的个人信息能力的截止时间由2021年4月13日调整至2021年4月28日24时。为优化用户的使用体验，平台将进行以下调整： 2021年2月23日起，若小程序已在微信开放平台进行绑定，则通过wx.login接口获取的登录凭证可直接换取unionID2021年4月28日24时后发布的小程序新版本，无法通过wx.getUserInfo与<button open-type="getUserInfo"/>获取用户个人信息（头像、昵称、性别与地区），将直接获取匿名数据（包括userInfo与encryptedData中的用户个人信息），获取加密后的openID与unionID数据的能力不做调整。此前发布的小程序版本不受影响，但如果要进行版本更新则需要进行适配。新增getUserProfile接口（基础库2.10.4版本开始支持），可获取用户头像、昵称、性别及地区信息，开发者每次通过该接口获取用户个人信息均需用户确认。具体接口文档：《getUserProfile接口文档》由于getUserProfile接口从2.10.4版本基础库开始支持（覆盖微信7.0.9以上版本），考虑到开发者在低版本中有获取用户头像昵称的诉求，对于未支持getUserProfile的情况下，开发者可继续使用getUserInfo能力。开发者可参考getUserProfile接口文档中的示例代码进行适配。请使用了wx.getUserInfo接口或<button open-type="getUserInfo"/>的开发者尽快适配。开发者工具1.05.2103022版本开始支持getUserProfile接口调试，开发者可下载该版本进行改造。 小游戏不受本次调整影响。 一、调整背景很多开发者在打开小程序时就通过组件方式唤起getUserInfo弹窗，如果用户点击拒绝，无法使用小程序，这种做法打断了用户正常使用小程序的流程，同时也不利于小程序获取新用户。 二、调整说明通过wx.login接口获取的登录凭证可直接换取unionID 若小程序已在微信开放平台进行绑定，原wx.login接口获取的登录凭证若需换取unionID需满足以下条件： 如果开发者帐号下存在同主体的公众号，并且该用户已经关注了该公众号如果开发者帐号下存在同主体的公众号或移动应用，并且该用户已经授权登录过该公众号或移动应用2月23日后，开发者调用wx.login获取的登录凭证可以直接换取unionID，无需满足以上条件。 回收wx.getUserInfo接口可获取用户个人信息能力 4月28日24时后发布的新版本小程序，开发者调用wx.getUserInfo或<button open-type="getUserInfo"/>将不再弹出弹窗，直接返回匿名的用户个人信息，获取加密后的openID、unionID数据的能力不做调整。 具体变化如下表： [图片] 即wx.getUserInfo接口的返回参数不变，但开发者获取的userInfo为匿名信息。  [图片] 此外，针对scope.userInfo将做如下调整： 若开发者调用wx.authorize接口请求scope.userInfo授权，用户侧不会触发授权弹框，直接返回授权成功若开发者调用wx.getSetting接口请求用户的授权状态，会直接读取到scope.userInfo为true新增getUserProfile接口 若开发者需要获取用户的个人信息（头像、昵称、性别与地区），可以通过wx.getUserProfile接口进行获取，该接口从基础库2.10.4版本开始支持，该接口只返回用户个人信息，不包含用户身份标识符。该接口中desc属性（声明获取用户个人信息后的用途）后续会展示在弹窗中，请开发者谨慎填写。开发者每次通过该接口获取用户个人信息均需用户确认，请开发者妥善保管用户快速填写的头像昵称，避免重复弹窗。 插件用户信息功能页 插件申请获取用户头像昵称与用户身份标识符仍保留功能页的形式，不作调整。用户在用户信息功能页中授权之后，插件就可以直接调用 wx.login 和 wx.getUserInfo 。 三、最佳实践调整后，开发者如需获取用户身份标识符只需要调用wx.login接口即可。 开发者若需要在界面中展示用户的头像昵称信息，可以通过<open-data>组件进行渲染，该组件无需用户确认，可以在界面中直接展示。 在部分场景（如社交类小程序）中，开发者需要在获取用户的头像昵称信息，可调用wx.getUserProfile接口，开发者每次通过该接口均需用户确认，请开发者妥善处理调用接口的时机，避免过度弹出弹窗骚扰用户。 微信团队 2021年4月15日