如何实现扫服务号带参二维码打开小程序

为了给广大用户在“扫码点餐”的场景提供更好的用户体验,不再需要“扫码关注后点餐”;同时,也为了兼容线下已有的二维码,微信公众平台开放扫描服务号带参链接二维码打开小程序能力。

能力介绍

  • 服务号带参链接二维码,是指开发者通过官方开放的“生成服务号带参数的二维码”接口生成的带参链接,形如 “http://weixin.qq.com/q/xxx” 的服务号带参链接。

  • 扫服务号带参二维码打开小程序,通过该能力,线下商户不需要更换线下带参二维码,通过开放的接口完成配置后,即可实现在用户扫描服务号带参链接二维码时打开小程序,使用小程序的功能。

开放范围

  • 服务号:已认证的服务号

  • 小程序:企业、媒体、政府及其他组织类型小程序,不支持个人主体。

相关规则

1、 1个小程序最多支持配置10w个服务号带参链接;即单个小程序,“创建二维码规则”的接口调用总次数为10w次。

2、 接口的调用限制为:200次/分钟,请注意使用频率。

对接说明

1、 获取服务号带参链接,如果是存量的链接,需开发者自行获取,平台不存储已经生成的服务号带参链接;如果是新增的链接,开发者可通过生成带参数的二维码接口进行生成。

2、 检查是否完成授权。若步骤1,也是服务商代创建的,那么该服务号是已经将“账号服务权限集”(权限集id为3)的权限授权给该服务商。“扫服务号带参二维码打开小程序”涉及的接口也是同在“账号服务权限集”中。如果尚未完成授权,则参考第三方授权的文档完成授权。

3、 调用接口添加二维码规则,在步骤1中获取到的服务号带参链接作为该接口的prefix的入参进行配置;规则添加后,需要调用接口发布已设置的二维码规则进行发布方可生效。

4、 如果规则配置错误了,则可以调用接口修改二维码规则,注意,已经发布的规则,不支持修改。

5、 如果想撤销已经发布生效的规则,则可以调用接口删除已设置的二维码规则,此时无需重新发布即可生效。

其他相关能力

  • 扫码关注组件:该能力用于在用户扫小程序码打开小程序时,开发者可在小程序内配置公众号关注组件,方便用户快捷关注公众号。相关详细的规则可查看official-account

扫码关注组件对接指南:

1、 设置展示的公众号调接口开启商家小程序的扫码关注组件,接口详情可点击查看设置展示的公众号信息

2、 设置之前可以调接口获取可以用来设置的公众号列表

3、 设置完成之后,可以调用接口获取展示的公众号信息

4、 补充说明,上述步骤涉及的接口属于开发管理与数据分析权限集(权限集id为18),若服务商需要代商家调用该接口应当获得商家小程序相关授权。