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

产品介绍

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

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

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

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. 在模拟器中进行调试。

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

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

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

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

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

5. 打开 联调设置。