本規(guī)范規(guī)定了微信支付二維碼的質(zhì)量要求，包括二維碼生成、展示、驗收和安全要求。

本規(guī)范適用于微信支付組織內(nèi)部、商戶、服務(wù)商使用二維碼實現(xiàn)收款、綁定設(shè)備或營銷等功能的產(chǎn)品中二維碼設(shè)計、展示和維護。

QRCode 國家標(biāo)準(zhǔn)（GB/T 18284-2000）

微信支付二維碼：微信支付提供給用戶或商戶產(chǎn)品中包含的二維碼，或商戶和服務(wù)商自行生成提供微信支付相關(guān)功能的二維碼。例如收款二維碼、付款二維碼、綁定設(shè)備碼或營銷功能二維碼等。

容錯等級：二維碼設(shè)計有容錯功能，當(dāng)二維碼局部區(qū)域被遮擋或污損時仍可以正常識別解碼。二維碼容錯等級分為4等（L、M、Q、H），等級越高對應(yīng)可恢復(fù)的碼字比例越高。

現(xiàn)有商戶H5收銀頁面未做適配大字體時會出現(xiàn)信息溢出、遮擋、重疊等情況，嚴(yán)重影響了用戶的閱讀和操作，應(yīng)避免以下幾類情況發(fā)生。

4.1. 二維碼碼制介紹

常用的二維碼碼制有：QR Code、漢信碼、PDF417二維條碼、Datamatrix二維條碼、Code 49、Code 16K、Code one等。樣例如圖1所示：

QR二維碼的相關(guān)背景知識可參考：https://www.qrcode.com/zh/index.html

4.2. 微信支付碼制標(biāo)準(zhǔn)

微信支付收款二維碼采用的碼制為快速響應(yīng)矩陣碼（簡稱QR Code），下文說的二維碼特指QR碼。商戶可通過引用符合QR碼國家標(biāo)準(zhǔn)（GB/T 18284-2000）的第三方庫生成收款二維碼（注意：不支持Micro QR和IQR碼標(biāo)準(zhǔn)）。

此外，如使用微信小程序提供對外服務(wù)，可將微信支付二維碼更換為小程序碼（如圖3所示），在小程序內(nèi)實現(xiàn)微信支付相關(guān)功能。

5.1.微信支付提供給商戶的二維碼

微信支付提供給商戶二維碼鏈接或圖片，例如生活繳費提供給商戶打印在繳費單上的繳費二維碼，如圖4所示:

圖4：生活繳費二維碼生成工具

微信支付提供模版下載二維碼圖片，如微信面對面收款二維碼（如圖5所示）和付款二維碼（如圖6所示）:

圖5：面對面收款二維碼

圖6：付款二維碼

微信支付對外提供實體物料上的二維碼，如微信買單碼牌的二維碼，如圖7所示:

圖7：微信買單二維碼碼牌

微信支付營銷宣傳物料或海報中使用的二維碼，如海報中心加好友二維碼，如圖8所示:

圖8：微信海報中的二維碼

微信支付對外提供設(shè)備上做綁定的二維碼，如收款機具綁定碼，收款音箱等，如圖9所示:

圖9：收款機具綁定二維碼

5.2.商戶自行生成二維碼場景

訂單小票二維碼：商戶將二維碼打印在訂單小票（如圖10所示）或繳費單（如圖11所示）上，用戶掃描后可完成支付:

圖10：超市訂單小票

圖11：醫(yī)院就診繳費單

WEB網(wǎng)頁收款二維碼：用戶在商戶WEB頁面下單后，直接掃描網(wǎng)頁上顯示的訂單二維碼完成付款，如圖12所示:

圖12：WEB頁面收款二維碼

自助點餐二維碼：用戶掃描帶有桌號的二維碼后打開H5或小程序，選擇商品確認(rèn)下單，最后直接完成支付，如圖13所示:

圖13：自助點餐二維碼,掃此碼可關(guān)注公眾號,需打碼

收銀臺收款二維碼：商戶提供收銀臺碼牌上的二維碼， 用戶掃描后可輸入金額完成支付，如圖14所示:

圖14：收銀臺收款二維碼

自助設(shè)備上的收款二維碼：展示在設(shè)備上，用戶掃描后付款，如圖15所示:

圖15：充電寶借還機器關(guān)注公眾號二維碼

停車場繳費牌收款二維碼：展示停車場的墻壁上，在用戶掃描二維碼打開H5頁面，輸入車牌信息完成付款，如圖16所示:

圖16：停車場收款二維碼

二維碼能否掃描會受到圖案完整度、圖案復(fù)雜度、顏色對比度、掃描距離、環(huán)境光線、掃描設(shè)備分辨率等因素的影響。編碼信息越多，二維碼圖案越復(fù)雜。超長內(nèi)容的二維碼圖案會非常復(fù)雜，需要足夠清晰的大圖才能完整展示。

6.1.二維碼生成標(biāo)準(zhǔn)

6.1.1.設(shè)置內(nèi)容格式

1.微信支付API返回給商戶的二維碼內(nèi)容:
統(tǒng)一使用“weixin://wxpay/自定義數(shù)據(jù)”格式協(xié)議，Native支付的二維碼內(nèi)容樣例：weixin://wxpay/bizpayurl/up?pr=NwY5Mz9

2.商戶自定義H5鏈接二維碼:
H5鏈接符合URL格式規(guī)范“https://域名/自定義數(shù)據(jù)”，自定義數(shù)據(jù)可由商戶根據(jù)場景需要設(shè)置對應(yīng)的內(nèi)容。

6.1.2.設(shè)置內(nèi)容長度

隨內(nèi)容長度增加二維碼密度會增大，當(dāng)二維碼顯示尺寸被限制時，點陣太密會導(dǎo)致二維碼難識別，甚至無法識別，二維碼識別效果對比如表1所示。

表1：同尺寸下不同內(nèi)容長度的二維碼

生成二維碼時，應(yīng)根據(jù)二維碼顯示區(qū)域邊長設(shè)置合理的內(nèi)容長度，內(nèi)容長度標(biāo)準(zhǔn)見表2所示。

表2：二維碼邊長對應(yīng)的內(nèi)容長度要求

如果實際內(nèi)容長度超過以上要求，請按以下措施減少字符長度：

URL域名：建議不超過15個字符，使用簡短的三級域名，不使用復(fù)雜的多級域名

URL路徑：使用簡短的路徑名，不使用多級目錄

URL參數(shù)：減少傳遞參數(shù)個數(shù)；縮短參數(shù)名長度；縮短參數(shù)值長度 如果以上措施仍無法滿足實際場景要求，可將鏈接轉(zhuǎn)為較短的鏈接，方法見附錄7.2節(jié)短鏈接最佳實踐。

6.1.3.設(shè)置容錯等級

二維碼容錯等級分為4等（L、M、Q、H），等級越高對應(yīng)可恢復(fù)的碼字比例越高，具體每個等級可恢復(fù)的字符比例為L：7%，M：15%，Q：25%，H：30%。相同長度的內(nèi)容，容錯等級越高，二維碼密度越大。

1、二維碼展示在屏幕、質(zhì)量較好的紙上或者有保護的碼牌，使用低容錯等級（建議使用L等級）；

2、二維碼打印在普通紙張展示，建議使用中容錯等級（建議使用M等級）

3、放置在有遮擋場景展示時，建議使用高容錯等級（Q或H等級）；

6.1.4.設(shè)置分辨率

二維碼展示在不同媒介上，對分辨率有不同的要求，為保證二維碼能夠清晰呈現(xiàn)并被掃描識別；作為屏幕使用時，建議二維碼圖像分辨率不小于72dpi，如圖17所示。印刷使用時建議二維碼圖像分辨率為300dpi或以上，如圖18所示。

圖17：屏幕顯示分辨率設(shè)置

圖18：印刷分辨率設(shè)置

6.2.二維碼展示標(biāo)準(zhǔn)

6.2.1.對比度

對比度、進(jìn)光量影響攝像頭的成像速度及掃碼效率，當(dāng)二維碼在不同媒介使用時，顯示效果可能不一樣，如圖19所示。為兼顧各種場景展示實現(xiàn)可掃描，建議二維碼點陣為黑色，背景為白色，不推薦使用灰色或彩色二維碼。

圖19：二維碼對比度展示樣例

6.2.2.二維碼尺寸

不同場景的使用，建議商戶按規(guī)范生成二維碼，如表3所示。商戶也可根據(jù)實際情況來調(diào)整二維碼尺寸，具體尺寸對應(yīng)內(nèi)容長度參見6.1.2節(jié)設(shè)置內(nèi)容長度。

表3：按場景選擇二維碼邊長

6.2.3.點陣遮擋

二維碼有容錯率限制，不建議覆蓋圖形元素。二維碼識別中存在三個關(guān)鍵定位點，如果這三個部位被遮擋，將無法識別到二維碼，如圖20所示。二維碼如果需要添加LOGO標(biāo)識，需使用居中覆蓋，如圖21所示，建議使用容錯等級為M的二維碼并保證覆蓋面積不超過10%，或者容錯能級為H的二維碼覆蓋面積不超過25%。進(jìn)行設(shè)備識別測試，通過后方可對外發(fā)布二維碼。

圖20：定位點不可遮擋	圖21：LOGO居中覆蓋

6.3.二維碼驗收要求

為滿足用戶微信支付掃描體驗要求，要做好收款二維碼的質(zhì)量檢查，收款二維碼上線前，需要在實際環(huán)境下測試和體驗，驗收完成再上線。上線后，要對收款二維碼做好日常維護。具體檢查項目和解決方案見表4。

表4：二維碼驗收檢查項

6.4.二維碼安全要求

防止二維碼被非法替換：對二維碼做好保護措施，可使用碼牌保護，放置到用戶不能接觸到的地方；

防偽要求：二維碼物料上可添加公司logo；

二維碼鏈接使用HTTPS協(xié)議，避免被注入腳本攻擊；

網(wǎng)站做好安全維護，防止用戶掃碼后下載病毒；

商品二維碼標(biāo)準(zhǔn)： 國家商品二維碼標(biāo)準(zhǔn)

名片二維碼： 名片二維碼通用技術(shù)規(guī)范

QR碼官方介紹： QR碼官方

7.2.長鏈轉(zhuǎn)短鏈最佳實踐

二維碼內(nèi)容對應(yīng)鏈接參數(shù)較多的情況，可以通過key-value機制實現(xiàn)長鏈接轉(zhuǎn)短鏈接。短鏈接中定義唯一ID（唯一ID可由字母+數(shù)組組合），鏈接訪問時，后臺通過ID映射跳轉(zhuǎn)到帶有參數(shù)的鏈接。

長鏈接URL示例：URL帶有多個參數(shù)，長度超過本規(guī)范建議長度樣例：
http://www.tg885.com/wiki/doc/apiv3/wxpay/pages/****.shtml?param1=1&code=aaa&id=12345

短鏈接示例：URL相對路徑短，只帶有一個參數(shù)，該參數(shù)可以作為唯一標(biāo)識對應(yīng)后臺的記錄（標(biāo)識生成規(guī)則：固定位數(shù)，如7位，通過大寫字母+小寫字母+數(shù)字組合）樣例：
https://qq.com?p=NwY5Mz9

7.3.收款二維碼參考樣例

微信支付常用二維碼的參數(shù)情況：

表5：微信支付二維碼參考樣例參數(shù)對比