微信小程序掃碼打開接入指南

1、功能介紹： 一、簡介 爲了方便小程序開發者更便捷地推廣小程序，兼容線下已有的二維碼，微信公衆平臺開放掃描普通連接二維碼跳轉小程序能力。

二、功能 普通連接二維碼，是指開發者使用工具對網頁連接進行編碼後生成的二維碼。線下商戶可不需更換線下二維碼，在小程序後臺完成配置後，便可在用戶掃描普通連接二維碼時打開小程序，使用小程序的功能。對於普通連接二維碼，目前支持使用微信「掃一掃」或微信內長按識別二維碼跳轉小程序。

2、開放範圍： 企業、媒體、政府及其餘組織類型小程序。

3、二維碼跳轉規則： 微信客戶端掃碼將按如下匹配規則控制跳轉： 《a》二維碼連接的協議、域名與已配置的二維碼規則一致。 《b》二維碼連接屬於後臺配置的二維碼規則的子路徑。（如需支持子路徑匹配，請確認後臺配置的二維碼規則以/結尾） 《c》 若是二維碼規則包含參數，連接?後爲參數部分，參數要求前綴匹配。

4、二維碼內容獲取： 在小程序後臺配置二維碼跳轉小程序規則以後便可使用微信（6.5.6及其以上客戶端版本）掃碼打開小程序。二維碼連接內容會以參數q的形式帶給頁面，在onLoad事件中提取q參數並自行decodeURIComponent一次，便可獲取原二維碼的完整內容。

5、配置流程： 一、二維碼規則 【1】二維碼規則的域名須經過ICP備案的驗證。 【2】支持http、https、ftp開頭的連接（如：wx.qq.com、wx.qq.com/mp/、https:/… 【3】一個小程序賬號可配置很少於10個二維碼前綴規則。

二、前綴佔用規則 開發者可選擇是否佔用符合二維碼匹配規則的全部子規則。如選擇佔用，則其餘賬號不可申請使用知足該前綴匹配規則的其餘子規則。如：若開發者A配置二維碼規則：wx.qq.com/mp?id=123，並…

三、校驗文件 下載隨機校驗文件，並將文件上傳至服務器指定位置的目錄下，方可經過所屬權校驗。驗證文件放置規則： 放置於URL中聲明的最後一級子目錄下，若無子目錄，則放置於host所屬服務器的頂層目錄下。請根據頁面提示將驗證文件放置在指定的目錄下。

四、小程序功能頁面 配置掃描二維碼後打開的小程序功能頁面路徑，如：pages/index/index。

五、測試調試 開發者可對已配置的二維碼規則進行測試和調試。測試僅對指定的測試連接和測試範圍內的微信用戶生效，其餘用戶掃碼後跳轉網頁，不影響全網用戶正常使用。在二維碼規則發佈後，開發者仍然能夠選擇在指定版本（開發版/體驗版/線上版本）下測試。 【1】測試範圍 開發者可根據開發進度選擇在開發板/體驗版/線上版本測試「普通二維碼跳轉小程序」的功能。 【2】測試連接 填寫符合二維碼前綴匹配規則的二維碼完整連接用於測試，如包括參數，請完整填寫。一個規則能夠填寫很少於5個測試連接，可屢次修改。若二維碼與測試連接匹配，且用戶微信號是小程序指定的管理員/開發者/體驗者，將打開指定版本的小程序。

六、發佈 測試完成後開發者可將二維碼跳轉規則發佈現網，發佈後掃描全部符合匹配規則的二維碼，將跳轉至指定的小程序頁面。爲確保用戶體驗，小程序必須先發布代碼才能夠發佈二維碼跳轉規則。一個小程序賬號一個月可發佈很少於20次二維碼跳轉規則。