支付宝小程序:关联普通二维码

小编:啊南 132阅读 2020.12.28

产品介绍

普通二维码是指开发者使用工具对网页链接进行编码后生成的二维码。

商户可不需更换线下二维码,通过在小程序后台设置关联规则,将原线下普通二维码的地址与小程序页面关联,用户用支付宝扫描该地址的普通二维码即可打开小程序并跳转到指定页面。r

准入条件

小程序版本上传至支付宝开放平台 后即可在管理后台配置,对企业和个人开发者均开放。

计费模式

不收费。

接入指引配置规则

说明:普通二维码关联小程序最多可设置 20 条规则。

目前小程序不支持通过接口配置小程序关联普通二维码,小程序关联普通二维码需要登录商户的小程序后台(登录 商家自运营中心 > 在相应小程序点击进入管理后台 > 推广获客 > 码管理),在码管理中进行配置关联。说明:当前小程序服务管理入口为更新后入口,旧版入口配置链接暂时保留。如下所示:

登录 开发者中心控制台 > 在相应小程序点击进入管理后台 > 码管理,在码管理中进行配置关联。

二维码地址

二维码地址须通过 ICP 备案的验证,支持http、https、ftp开头的链接(如:http://www.alipay.com、https://www.alipay.com/my/、https://www.alipay.com/my?id=123)

匹配规则

支持按域名 精确匹配模糊匹配 两种方式:

  • 精确匹配:根据填写的二维码地址精确匹配,地址完全一致时才能唤起小程序并跳转到指定页面(如:配置二维码地址为 https://www.alipay.com/my/doc?id=123 ,当用户扫这个地址的二维码可唤起小程序)。

  • 模糊匹配:根据填写的二维码地址前缀模糊匹配,只要地址前缀匹配即可唤起小程序跳转到指定页面(如:配置二维码地址为 https://www.alipay.com/my/ ,当用户扫的二维码地址为 https://www.alipay.com/my/doc?id=123 可唤起小程序,只要前缀完全匹配即可唤起小程序)。

校验文件

下载随机校验文件,并将校验文件放置于二维码地址域名的根目录下,方可通过所属权校验。

上传后,点击确认校验文件即可正常访问。

为保持验证通过的状态,成功验证后请不要删除校验文件。

小程序功能页面

配置扫描二维码后打开的小程序功能页面路径,如:pages/index/index。

调试测试

开发者可对已配置的二维码规则进行测试和调试,可扫系统生成的二维码来进行测试。

该配置可对体验版和开发版生效,当扫体验版/开发版二维码唤起体验版小程序后,再扫普通二维码即可唤起对应版本的小程序来测试开发的新功能。



onLaunch(options){    my.alert({      title: 'app onLaunch',      content:  JSON.stringify(options),      success: (res) => {          //成功处理代码段      },    });    //获取关联普通二维码的码值,放到全局变量qrCode中  if (options.query && options.query.qrCode) {      this.qrCode = options.query.qrCode;    }  }




参数名 描述
path 当前路径。若没有填写目标页面,那么当前路径为首页(如下图);若填写则返回目标页面的路径。
qrCode 二维码码值。

发布

测试完成后开发者可将二维码跳转规则发布上线,发布后扫描所有符合匹配规则的二维码,将跳转至指定的小程序页面。

IDE 调试启动参数

比如普通二维码码值是 http://商户网站域名?bb=cc&dd=ff

  1. 对其做 URLENCODE ,得到 http%3a%2f%2f%e5%95%86%e6%88%b7%e7%bd%91%e7%ab%99%e5%9f%9f%e5%90%8d%3fbb%3dcc%26dd%3dff。

  2. 打开 IDE 顶部功能区中的添加编译模式,选择自定义编译。

  1. 在之前得到的参数前面加上 “qrCode=” 后填入启动参数并确认。

  1. 在模拟器中进行调试。

FAQQ:如何测试配置的普通关联二维码规则?

A:如何测试配置的普通关联二维码规则如下:

  1. 小程序已经上架过版本,可以直接扫码跳转;未上架过版本直接扫码会提示:“版本过低建议升级支付宝”。r

  2. 体验版测试:普通关联二维码规则发布后,重新设置体验版 > 扫一扫体验版二维码 > 进入小程序后退出 > 再扫普通二维码规则生成的二维码。r

  3. 开发版测试:普通关联二维码规则发布后,重新推送真机预览 > 扫一扫开发版二维码 > 进入小程序后退出 > 再扫普通二维码规则生成的二维码。r

  4. IDE 工具测试:编辑器找到 普通编译 > 点击 添加编译模式 > 设置全局参数进行测试。

  5. 打开 联调设置。


关联标签: