支付寶小程序：關聯普通二維碼

產品介紹

普通二維碼是指開發者使用工具對網頁鏈接進行編碼后生成的二維碼。

商戶可不需更換線下二維碼，通過在小程序后臺設置關聯規則，將原線下普通二維碼的地址與小程序頁面關聯，用戶用支付寶掃描該地址的普通二維碼即可打開小程序并跳轉到指定頁面。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. 打開 聯調設置。