1. 范圍

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

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

2. 規(guī)范性引用文件

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

3. 術(shù)語和定義

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

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

4. 二維碼介紹

4.1. 二維碼碼制介紹

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

圖1 二維碼樣例

QR二維碼的相關(guān)背景知識(shí)可參考：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)）。

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

5. 二維碼使用場景

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

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

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

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

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

圖6：付款二維碼

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

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

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

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

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

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

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

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

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

圖12：WEB頁面收款二維碼

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

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

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

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

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

圖15：充電寶借還機(jī)器收款二維碼

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

圖16：停車場收款二維碼

6. 二維碼技術(shù)要求

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

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

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

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

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

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

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

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

如果以上措施仍無法滿足實(shí)際場景要求，可將鏈接轉(zhuǎ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：7%，M：15%，Q：25%，H：30%。相同長度的內(nèi)容，容錯(cuò)等級(jí)越高，二維碼密度越大。

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

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

3、放置在有遮擋場景展示時(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所示。為兼顧各種場景展示實(shí)現(xiàn)可掃描，建議二維碼點(diǎn)陣為黑色，背景為白色，不推薦使用灰色或彩色二維碼。

6.2.2. 二維碼尺寸

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

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

6.2.3. 點(diǎn)陣遮擋

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

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

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

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

6.4. 二維碼安全要求

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

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

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

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

7. 附錄

7.1. 參考文獻(xiàn)

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

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

QR碼官方介紹： QR碼官方

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

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

長鏈接URL示例：URL帶有多個(gè)參數(shù)，長度超過本規(guī)范建議長度樣例：

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位，通過大寫字母+小寫字母+數(shù)字組合）樣例：

https://qq.com?p=NwY5Mz9

7.3. 收款二維碼參考樣例

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

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