支付寶小程序:模板模式接入關聯普通二維碼

小編:啊南 93閱讀 2020.12.28

產品介紹

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

商家可不需更換線下二維碼,通過在小程序后臺設置新的關聯規則,將原線下普通二維碼的地址與小程序頁面關聯,用戶用支付寶掃描該地址的普通二維碼即可打開小程序并跳轉到指定頁面。r

系統服務商(ISV)推廣小程序模板時,常常需要在商家訂購小程序之前,預先生產對應的普通二維碼物料。后續每有一個商家成功訂購小程序模板,就可以立即為其配發一定數量的線下二維碼物料,作為此小程序的流量入口。

系統服務商(ISV)在設計線下二維碼物料時,建議遵循下文的設計規范,做好相關規劃,以便后續能通過統一的規則高效管理所有線下二維碼。

設計規范r原則

同一個商家的所有二維碼地址,都擁有相同的 URL 地址前綴,且該地址前綴是該商家獨享的。

示例

例如,商家 A 的所有二維碼(如下),都以 https://www.openhome.com/a 開頭,該地址前綴為商家 A 獨享。

https://www.openhome.com/a/001

https://www.openhome.com/a/002/abc

https://www.openhome.com/a/003/def/ghi

... ...

商家 B 的所有二維碼(如下),都以 https://www.openhome.com/b 開頭,該地址前綴為商家 B 獨享。

https://www.openhome.com/b/001

https://www.openhome.com/b/002/abc

https://www.openhome.com/b/003/def/ghi

... ...

優勢

在為小程序關聯普通二維碼時,每個商家小程序,只需要配置一條規則即可?梢源蠓冉档投S碼部署的復雜度,以及提升二維碼的掃碼效率。

例如,商家 A 的小程序,配置的關聯規則如下圖所示。

接入流程
  1. 上傳模板代碼版本后,在 開放平臺控制臺 > 三方服務 > 小程序模板,選擇需要的模板,在 碼管理 > 關聯普通二維碼,點擊 添加。

    image

?

  1. 無需在模板的 碼管理 中真的配置規則,只需按照提示,正確完成匹配規則中二維碼地址的域名校驗即可。

    a. 下載檢驗文件;

    b. 將校驗文件放置于二維碼的域名根目錄下;

    例如,需要關聯的二維碼域名是 a.b.com/1/qrcode1 和 a.b.com/2/qrcode2,則只需要驗證 b.com 域名即可。

    c. 點擊頁面上的驗證按鈕,確認驗證文件可以正常訪問。

    ?

精確匹配模糊匹配 區別:

  • 精確匹配:根據填寫的二維碼地址精確匹配,地址完全一致時才能喚起小程序并跳轉到指定頁面(如:配置二維碼地址為 https://www.alipay.com/my/doc?id=123 ,當用戶掃這個地址的二維碼可喚起小程序)。

  • 模糊匹配:根據填寫的二維碼地址前綴模糊匹配,只要地址前綴匹配即可喚起小程序跳轉到指定頁面(如:配置二維碼地址為 https://www.alipay.com/my/ ,當用戶掃的二維碼地址為 https://www.alipay.com/my/doc?id=123 可喚起小程序,只要前綴完全匹配即可喚起小程序)。

  1. 構建商家小程序版本,第三方應用代商家小程序調用 alipay.open.mini.qrcode.bind 接口,為商家小程序關聯在模板碼管理中已校驗域名的普通二維碼。

    即入參 route_url 的域名是在模板碼管理中已校驗的(上述步驟 2.C)。


說明:


  • 不同的商家小程序需關聯不同的普通二維碼,即需保證不同商家關聯的二維碼地址不同。

  • 如需刪除關聯規則,可調用 alipay.open.mini.qrcode.unbind 接口,刪除商家小程序中已關聯的二維碼。

  • 若商家小程序沒有生成體驗版,調用關聯普通二維碼接口會失敗。請生成體驗版或商家小程序有上架版本后,再調用關聯普通二維碼接口。



獲取二維碼碼值

獲取二維碼碼值請在小程序 app.js 文件的 app() 的 onLaunch() 方法中使用 options.query 獲取,解析碼值可得到二維碼地址?后的所攜參數,代碼示例如下:

onLaunch(options){r    my.alert({r      title: 'app onLaunch',r      content:  JSON.stringify(options),r      success: (res) => {r          //成功處理代碼段r      },r    });r  r  //獲取關聯普通二維碼的碼值,放到全局變量qrCode中r  if (options.query && options.query.qrCode) {r      this.qrCode = options.query.qrCode;r    }  r
參數名 描述
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. 在模擬器中進行調試。

常見問題Q:第一次掃碼進入小程序,切入后臺。第二次掃碼進入后,在 onLaunch 函數中獲取不到參數,如何解決?

A:建議在 app.js 的 onLaunch 和 onShow 函數中都嘗試獲取參數。

Q:在模板中添加了域名,調用接口時還是提示“HOST_VERIFY_FAILD 域名校驗失敗 ”,如何解決?

A:添加域名應在第三方應用的域白名單中添加,之后,需要重新構建商家小程序版本,進行提審并通過后,新的配置才會在商家小程序中生效。

Q:調用接口時提示“TEMPLATE_NOT_HAVE_HOST t非模板名下持有域名”,如何解決?

A:請檢查:

  1. 需要配置規則的小程序必須是該模板實例化出來的;

  2. 按照操作流程 2.C 的說明,正確完成域名校驗。

關聯標簽:
欧美日韩在线精品视频二区_日本高清在线精品一区_天天看片天天av免费观看