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

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

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

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

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

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

4.1. 二維碼碼制介紹

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

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

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

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

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

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

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

圖4：生活繳費(fèi)二維碼生成工具

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

圖5：面對(duì)面收款二維碼

圖6：付款二維碼

微信支付對(duì)外提供實(shí)體物料上的二維碼，如微信買(mǎi)單碼牌的二維碼，如圖7所示:

圖7：微信買(mǎi)單二維碼碼牌

微信支付營(yíng)銷宣傳物料或海報(bào)中使用的二維碼，如海報(bào)中心加好友二維碼，如圖8所示:

圖8：微信海報(bào)中的二維碼

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

圖9：收款機(jī)具綁定二維碼

5.2.商戶自行生成二維碼場(chǎng)景

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

圖10：超市訂單小票

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

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

圖12：WEB頁(yè)面收款二維碼

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

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

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

圖14：收銀臺(tái)收款二維碼

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

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

停車(chē)場(chǎng)繳費(fèi)牌收款二維碼：展示停車(chē)場(chǎng)的墻壁上，在用戶掃描二維碼打開(kāi)H5頁(yè)面，輸入車(chē)牌信息完成付款，如圖16所示:

圖16：停車(chē)場(chǎng)收款二維碼

二維碼能否掃描會(huì)受到圖案完整度、圖案復(fù)雜度、顏色對(duì)比度、掃描距離、環(huán)境光線、掃描設(shè)備分辨率等因素的影響。編碼信息越多，二維碼圖案越復(fù)雜。超長(zhǎng)內(nèi)容的二維碼圖案會(huì)非常復(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ù)場(chǎng)景需要設(shè)置對(duì)應(yīng)的內(nèi)容。

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

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

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

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

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

如果實(shí)際內(nèi)容長(zhǎng)度超過(guò)以上要求，請(qǐng)按以下措施減少字符長(zhǎng)度：

URL域名：建議不超過(guò)15個(gè)字符，使用簡(jiǎn)短的三級(jí)域名，不使用復(fù)雜的多級(jí)域名

URL路徑：使用簡(jiǎn)短的路徑名，不使用多級(jí)目錄

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

6.1.3.設(shè)置容錯(cuò)等級(jí)

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

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

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

3、放置在有遮擋場(chǎng)景展示時(shí)，建議使用高容錯(cuò)等級(jí)（Q或H等級(jí)）；

6.1.4.設(shè)置分辨率

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

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

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

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

6.2.1.對(duì)比度

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

圖19：二維碼對(duì)比度展示樣例

6.2.2.二維碼尺寸

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

表3：按場(chǎng)景選擇二維碼邊長(zhǎng)

6.2.3.點(diǎn)陣遮擋

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

圖20：定位點(diǎn)不可遮擋	圖21：LOGO居中覆蓋

6.3.二維碼驗(yàn)收要求

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

表4：二維碼驗(yàn)收檢查項(xiàng)

6.4.二維碼安全要求

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

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

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

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

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

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

QR碼官方介紹： QR碼官方

7.2.長(zhǎng)鏈轉(zhuǎn)短鏈最佳實(shí)踐

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

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

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

7.3.收款二維碼參考樣例

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

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