● 設(shè)備ID：sku1007
● 設(shè)備名稱：華捷攝像頭
● 設(shè)備品牌：華捷艾米A200豎版 （校園食堂刷臉產(chǎn)品匹配攝像頭型號(hào)為：豎版A200+mini）
● 商戶所屬行業(yè)：校園
● 商戶介紹：「校園食堂刷臉項(xiàng)目」本次攝像頭申請(qǐng)合計(jì)10個(gè)學(xué)校，合計(jì)xx個(gè)食堂，一共有xx個(gè)檔口，需要xx個(gè)攝像頭，該學(xué)校總體消費(fèi)支付日均消費(fèi)筆數(shù)xx筆，日均消費(fèi)金額xxx元。然后把每個(gè)學(xué)校明細(xì)列舉，需提供學(xué)校名稱、學(xué)校人數(shù)、設(shè)備數(shù)量。
● 校園食堂刷臉產(chǎn)品匹配攝像頭型號(hào)為：豎版A200+mini，請(qǐng)務(wù)必在備注欄填寫所需要數(shù)據(jù)線型號(hào)（70cm彎頭數(shù)據(jù)線、120cm直頭數(shù)據(jù)線二選一），無(wú)備注要求默認(rèn)不發(fā)送數(shù)據(jù)線！

特別說(shuō)明：
a. 收貨地址要求：申請(qǐng)的攝像頭需要發(fā)通過(guò)驗(yàn)證的硬件商進(jìn)行生產(chǎn)后出貨，服務(wù)商申請(qǐng)攝像頭前需要確定合作的硬件商，所以地址需留硬件商地址。
b. 線上申請(qǐng)后請(qǐng)?jiān)谖⑿湃簝?nèi)告知申請(qǐng)子商戶商戶號(hào)及服務(wù)商主體：
服務(wù)商商戶名稱：智校XX有限公司
特約商戶名稱：哈XX中學(xué)
申請(qǐng)日期：XXXX年XX月XX日

（4）攝像頭發(fā)貨后需要考核服務(wù)商鋪設(shè)落地活躍率
服務(wù)商申請(qǐng)攝像頭，微信發(fā)貨6個(gè)月后考核人臉機(jī)具落地交易率是否≥?80%，且已落地的機(jī)具自然月臺(tái)日均交易筆數(shù)是否≥70。每個(gè)月監(jiān)控與考核用戶對(duì)應(yīng)申請(qǐng)?jiān)路莸幕钴S率，未達(dá)標(biāo)者，暫停其攝像頭的申請(qǐng)，并可能影響其后續(xù)返傭的獲取。

落地交易率計(jì)算活躍示例：

自然月臺(tái)日均交易筆數(shù)計(jì)算示例：

1.4.2 自行采購(gòu)攝像頭-非團(tuán)餐機(jī)
對(duì)于非團(tuán)餐機(jī)，如牛奶機(jī)、門禁機(jī)、視頻公話機(jī)等設(shè)備類型。微信支付不贈(zèng)送攝像頭，需要因?qū)W校場(chǎng)景室內(nèi)外光線差異大、身高差異大，針對(duì)分別推薦不同攝像頭型號(hào)如下：

牛奶機(jī)
攝像頭選型建議：針對(duì)自助售貨機(jī)一般處于室外光照較強(qiáng)場(chǎng)景，且校園學(xué)生身高差距較大。允許在校園自助機(jī)使用的攝像頭型號(hào)為RMSL201、RMSL205、華捷A100EX、華捷A200EX，以上四款攝像頭具有較好的戶外適應(yīng)性和垂直高度更高的視場(chǎng)角，可參考《攝像頭文檔》。

針對(duì)已集成結(jié)構(gòu)情況，若已集成華捷A200型號(hào)，硬件結(jié)構(gòu)調(diào)整困難，可以繼續(xù)申請(qǐng)華捷A200EX，提升識(shí)別效果；若已集成華捷A100型號(hào)，不存在硬件結(jié)構(gòu)調(diào)整，建議申請(qǐng)RK系列攝像頭，獲得更好的識(shí)別效果。

門禁機(jī)
目前微信刷臉支付支持使用并已通過(guò)驗(yàn)收的2D攝像頭可查看如下表中微信刷臉已驗(yàn)收的2D攝像頭表格， 內(nèi)含各攝像頭廠商型號(hào)規(guī)格及聯(lián)系方式。

視頻公話機(jī)
為保證微信刷臉支付用戶體驗(yàn)，微信刷臉支付針對(duì)攝像頭的引入進(jìn)行了嚴(yán)格的測(cè)試和認(rèn)證，目前微信刷臉支付支持使用的攝像頭列表如下：

1.4.3 過(guò)檢設(shè)備名錄
軟件服務(wù)商使用的刷臉支付設(shè)備須在《人臉開放平臺(tái)過(guò)檢設(shè)備名錄-K12校園行業(yè)類》范圍內(nèi)的設(shè)備，或通過(guò)“微信支付硬件服務(wù)”公眾號(hào)獲取過(guò)檢設(shè)備名錄；自行聯(lián)系設(shè)備廠商采購(gòu)設(shè)備；如若需要了解更多設(shè)備過(guò)檢狀態(tài)，可聯(lián)系刷臉支付項(xiàng)目經(jīng)理確認(rèn)。

學(xué)校場(chǎng)景需要配套符合場(chǎng)景的設(shè)備。形態(tài)為團(tuán)餐機(jī)，推薦選用在產(chǎn)品庫(kù)內(nèi)且經(jīng)過(guò)第三方檢測(cè)和國(guó)家認(rèn)證的設(shè)備。

# 2. 交互設(shè)計(jì)及開發(fā)指引

軟件開發(fā)需滿足整體體驗(yàn)要求：用戶在微信刷臉支付設(shè)備上，完成一筆完整的刷臉支付交易的過(guò)程體驗(yàn)，包括：所見界面、刷臉過(guò)程、各環(huán)節(jié)等待時(shí)長(zhǎng)到最終完成一筆刷臉交易；

共3部分：交互及設(shè)計(jì)規(guī)范、體驗(yàn)指標(biāo)要求、交易上報(bào)。

# 2.1 交互及設(shè)計(jì)規(guī)范

商戶/服務(wù)商需參考《微信刷臉支付-商戶APP設(shè)計(jì)指引》進(jìn)行軟件方案設(shè)計(jì)和開發(fā)。

# 2.2 刷臉SDK接入

商戶軟件涉及刷臉功能的部分，參考《K12開發(fā)文檔》進(jìn)行開發(fā)接入。

# 3. 平臺(tái)能力接入

# 3.1 采集和簽約小程序接入

服務(wù)商采集小程序申請(qǐng)與綁定常見問(wèn)題
（1）服務(wù)商申請(qǐng)進(jìn)行小程序創(chuàng)建后，怎么去采集人臉信息？
答：服務(wù)商創(chuàng)建好小程序后，服務(wù)商側(cè)，采集人臉是跳轉(zhuǎn)到微信官方采集人臉小程序，簽約是調(diào)起簽約組件即可。

（2）服務(wù)商創(chuàng)建小程序、申請(qǐng)創(chuàng)建小程序的流程和注意事項(xiàng)？
答：請(qǐng)參考《小程序注冊(cè)流程》。

注意：
a. 小程序內(nèi)容不能涉及發(fā)布失敗，提示涉及采集用戶生物特征（人臉照片或視頻）及其他敏感信息，平臺(tái)暫不支持？
答：服務(wù)商小程序調(diào)取官方采集人臉小程序，所以小程序是不能做這些內(nèi)容的，建議在申請(qǐng)時(shí)候說(shuō)清楚業(yè)務(wù)情況。
b. 小程序如果要做訂餐業(yè)務(wù)需要怎么樣的資質(zhì)？
答：上線訂餐需要有相關(guān)的餐飲許可證等證件。
c. 小程序的采集業(yè)務(wù)是必須先在公眾號(hào)綁定學(xué)生，然后才能在小程序進(jìn)行人臉采集。這個(gè)小程序發(fā)布被駁回了？為什么？
答：小程序的申請(qǐng)發(fā)布不能涉及誘導(dǎo)性分享，小程序涉及強(qiáng)制誘導(dǎo)性分享，因此不能通過(guò)。

（3）服務(wù)商創(chuàng)建的小程序和商戶號(hào)是同主體，存在多個(gè)APP id該如何進(jìn)行綁定？
答：服務(wù)商只能綁定一個(gè)app id，默認(rèn)綁定申請(qǐng)生成商戶號(hào)對(duì)應(yīng)的公眾號(hào)app id。如果需要替換為新申請(qǐng)的APPid，需要先解綁之前默認(rèn)綁定的app id。

（4）學(xué)校商戶號(hào)收款需要調(diào)起服務(wù)商簽約采集的小程序app id，需要在服務(wù)商后臺(tái)進(jìn)行綁定后才能調(diào)起支付成功。
答：服務(wù)商為特約商戶配置App ID（即sub_appid）操作指引請(qǐng)參考：https://kf.qq.com/faq/190715yaYnYv1907153mmIbA.html。

# 3.2 離線SDK接入

平臺(tái)提供一個(gè)支持離線識(shí)別的SDK，該SDK只能在指定類型設(shè)備上使用，需要合作伙伴自行開發(fā)完整APP并集成SDK，且需要開發(fā)對(duì)應(yīng)的手機(jī)端小程序產(chǎn)品以保證完整的用戶體驗(yàn)。離線SDK模式覆蓋支付能力及門禁能力，并兼容指定型號(hào)2D攝像頭使用門禁能力。

該模式適合半封閉或全封閉型場(chǎng)景如學(xué)校等，需要合作伙伴有較強(qiáng)的開發(fā)能力。

3.2.1 離線SDK申請(qǐng)
請(qǐng)先獲取測(cè)試版本SDK，進(jìn)行功能調(diào)通，全流程調(diào)通后請(qǐng)錄制視頻與截圖發(fā)送郵件給微信支付刷臉團(tuán)隊(duì)進(jìn)行審核。

測(cè)試版SDK獲取地址：
微信支付刷臉門禁聯(lián)調(diào)對(duì)接
微信支付K12團(tuán)餐聯(lián)調(diào)對(duì)接
微信支付K12視頻公話機(jī)聯(lián)調(diào)對(duì)接

（1）使用《開發(fā)檢測(cè)工具》完成設(shè)備檢測(cè)附上截圖，下載并填寫《軟件預(yù)檢測(cè)用例》。
● Tab 硬件規(guī)格
● Tab 1.安全
● Tab 2.系統(tǒng)功能(支付)
● Tab 3.系統(tǒng)功能(系統(tǒng)設(shè)置)

（2）MP4格式的真機(jī)演示視頻，視頻應(yīng)包含完整購(gòu)物流程，并控制視頻大小不超過(guò)20MB。

（3）設(shè)備安裝&操作指引.PDF格式可參考《桑達(dá)3308手冊(cè)》。

（4）下載并填寫《攝像頭測(cè)試Checklist》。

整理好以上文件，通過(guò)微信支付商戶平臺(tái)?->產(chǎn)品中心->我的工具箱->設(shè)備服務(wù)商 選擇對(duì)應(yīng)的設(shè)備型號(hào)(若無(wú)對(duì)應(yīng)設(shè)備型號(hào)請(qǐng)先添加設(shè)備型號(hào)），點(diǎn)擊「查看」按鈕，選擇「軟件檢測(cè)」，可以提交該設(shè)備型號(hào)的樣機(jī)檢測(cè)文件。
詳情提交信息可參考設(shè)備型號(hào)添加。

（5）功能調(diào)通頁(yè)面及視頻包括：
● 小程序流程及交互(視頻錄制及截圖)
● 終端頁(yè)面流程及交互(視頻錄制及截圖)
● 測(cè)試扣費(fèi)憑證(視頻錄制及截圖)

申請(qǐng)方式：
郵件發(fā)送：v_ronghanxu@tencent.com
郵件抄送：frostpeng@tencent.com;ethantjli@tencent.com;kingsleycwu@tencent.com;chunhohuang@tencent.com;
gatlin@tencent.com;taraye@tencent.com;curveyuan@tencent.com;carolinexu@tencent.com;v_xlanzhang@tencent.com;
v_zhiqangli@tencent.com;v_tintnzhao@tencent.com;v_yinxiding@tencent.com;?v_yawexiao@tencent.com;v_quandu@tencent.com
主題格式：[微信人臉開放平臺(tái)正式版離線識(shí)別SDK申請(qǐng)][服務(wù)商名稱][設(shè)備型號(hào)]
正文包括如下：
你好，xxxx公司申請(qǐng)正式版離線SDK
1. 附件材料說(shuō)明
2. 業(yè)務(wù)鋪設(shè)學(xué)校數(shù)量、預(yù)計(jì)落地設(shè)備數(shù)量
3. 微信分配的設(shè)備型號(hào)前綴
附件包含小程序采集簽約流程、終端完整支付流程、終端異常流程與家長(zhǎng)微信支付消息/服務(wù)商公眾號(hào)（小程序）支付消息頁(yè)面。

3.2.2 獲取正式的終端SDK
審核通過(guò)后，憑審核通過(guò)結(jié)果郵件聯(lián)系微信刷驗(yàn)支付團(tuán)隊(duì)，發(fā)放正式的終端SDK。

# 3.3 墊資能力接入

3.3.1 墊資限制及注意事項(xiàng)
（1）行業(yè)限制
目前僅K12學(xué)校支持接入墊資能力，高校及企業(yè)暫不支持。

（2）場(chǎng)景限制
目前僅食堂團(tuán)餐場(chǎng)景支持墊資。

（3）墊資額度及次數(shù)限制
● 用戶墊資次數(shù)及額度限制：
a. 每個(gè)用戶可墊資次數(shù)上限：3次
b. *達(dá)到3次上限后，需先還款才可以繼續(xù)使用墊資
c. 每個(gè)用戶單筆墊資額度上限：100元
● 總體墊資額度上限：
微信支付根據(jù)服務(wù)商下接入本產(chǎn)品的商戶交易筆數(shù)及增幅計(jì)算總墊資額度，僅支持正常交易情況下的墊資需求，若超出墊資總額度，平臺(tái)將無(wú)法為服務(wù)商下的商戶訂單進(jìn)行墊資。
● 其他墊資說(shuō)明：
用戶側(cè)不感知某筆訂單是否被墊資，也即無(wú)論該筆訂單墊資成功或失敗，用戶不會(huì)收到任何帶“墊資”字樣的信息，僅在墊資成功后會(huì)收到欠款通知。

（4）注意事項(xiàng)
a. 服務(wù)商需要做相應(yīng)風(fēng)險(xiǎn)控制策略以保障墊資能力正常使用：
● 用戶在墊資次數(shù)達(dá)上限后禁止進(jìn)行刷臉支付，防止出現(xiàn)離線模式下交易完成但無(wú)法墊資造成壞賬的情況；
● 不可對(duì)外展示用戶墊資的限制規(guī)則，并制定額外風(fēng)控策略，防止出現(xiàn)惡意欠款產(chǎn)生異常大量墊資的情況。

b. 平臺(tái)墊資的暫時(shí)性
● 墊資目的為保障商戶的利益與體驗(yàn)，支持業(yè)務(wù)迅速推廣上線。墊資資金前期將由微信支付平臺(tái)出資，后期規(guī)劃開發(fā)相應(yīng)產(chǎn)品能力支持服務(wù)商出資進(jìn)行墊資。

3.3.2 申請(qǐng)接入流程
（1）與運(yùn)營(yíng)經(jīng)理溝通接入墊資需求的背景

（2）申請(qǐng)方式
● 申請(qǐng)表模板請(qǐng)下載：墊資接入需求申請(qǐng)表
郵件發(fā)送：wxpay_edu@tencent.com
郵件抄送：kingsleycwu@tencent.com;ethantjli@tencent.com;zlxiang@tencent.com;v_ynfengliu@tencent.com;
leosgwan@tencent.com;brucefu@tencent.com;v_jahaochen@tencent.com
主題格式：[墊資接入需求申請(qǐng)表][服務(wù)商名稱][日期]
正文包括如下：
你好，我司申請(qǐng)接入墊資功能，以XXXXXX（說(shuō)明接入墊資的原因），請(qǐng)審批。
附件加上墊資接入需求申請(qǐng)表
特別說(shuō)明：
● 服務(wù)商開通刷臉代扣權(quán)限后再提交墊資申請(qǐng)；
● 提交后需要發(fā)郵件向運(yùn)營(yíng)同步申請(qǐng)表已提交完成。

（3）運(yùn)營(yíng)經(jīng)理審核申請(qǐng)表并進(jìn)行墊資配置，配置完成以郵件回復(fù)方式同步服務(wù)商。

（4）測(cè)試：服務(wù)商準(zhǔn)備一個(gè)已開通校園刷臉服務(wù)的微信號(hào)做功能測(cè)試，詳情請(qǐng)查閱測(cè)試用例。

（5）每周配置1次。

# 3.4 指定銀行卡能力

3.4.1 行業(yè)痛點(diǎn)
銀行有開卡/活卡訴求，但一直缺少低成本、大量獲取用戶的渠道。在校園新生入校、家長(zhǎng)辦卡是一個(gè)投入少、產(chǎn)出高的場(chǎng)景，銀行為此愿意出資購(gòu)買設(shè)備，承擔(dān)服務(wù)商的學(xué)校落地成本。

3.4.2 產(chǎn)品價(jià)值

3.4.3 產(chǎn)品介紹

開卡&簽約業(yè)務(wù)流程：

業(yè)務(wù)界面示意：

開卡&簽約完整流程：

流程說(shuō)明：
（1）開卡：
● 線下辦卡：用戶已在線下辦理了銀行卡，只需在「k12小程序」進(jìn)行綁卡和簽約。
● 線上辦卡：用戶先在「商戶小程序」完成開卡，然后跳轉(zhuǎn)到「k12小程序」綁卡和簽約。

（2）綁卡：
● 一鍵綁卡：系統(tǒng)判斷指定卡是否添加到微信支付賬號(hào)，如果已添加，則直接進(jìn)入簽約頁(yè)面；如果未添加，需要短信驗(yàn)證快速綁卡。
● 降級(jí)普通簽約：在綁卡短信驗(yàn)證時(shí)，如果銀行判斷手機(jī)號(hào)預(yù)留不一致、導(dǎo)致無(wú)法簽約，服務(wù)商可調(diào)用降級(jí)接口，允許用戶不綁卡、使用普通方式簽約。

（3）簽約：
● 指定卡簽約：有限定卡和優(yōu)先卡兩種模式。
限定卡模式：用戶只能用指定的銀行卡號(hào)進(jìn)行綁卡和簽約。
優(yōu)先卡模式：用戶如果指定卡號(hào)綁卡失敗，部分情況下允許降級(jí)為普通簽約。
目前只有工行的“用戶輸入的手機(jī)號(hào)與銀行預(yù)留手機(jī)號(hào)不符合”可以降級(jí)，如果其他錯(cuò)誤碼也想要降級(jí)，服務(wù)商可以提出申請(qǐng)、平臺(tái)進(jìn)行配置。
● 普通簽約：簽約頁(yè)面的支付方式可選擇任意卡或零錢支付。

（4）扣款：
● 指定卡簽約：扣款時(shí)只能從該卡扣款，無(wú)法從其他卡或零錢扣款。
● 普通簽約：扣款時(shí)系統(tǒng)自動(dòng)輪詢使用銀行卡或零錢。

（5）平臺(tái)墊資：指定卡簽約無(wú)墊資，普通簽約有墊資。

3.4.4 接入指引
離線刷臉商戶接入可查閱“開發(fā)指引”的“K12開發(fā)文檔”中《4.后臺(tái)接口》內(nèi)容。

3.4.5 常見問(wèn)題
（1）用戶身份與微信賬號(hào)實(shí)名不一致？
請(qǐng)先確定「開卡人信息」與「微信賬號(hào)實(shí)名」一致，才能完成簽約。若不一致請(qǐng)更換使用開卡人的微信號(hào)或修改此微信號(hào)的實(shí)名認(rèn)證。

（2）用戶綁卡短信驗(yàn)證，返回預(yù)留手機(jī)號(hào)不一致？
在短信驗(yàn)證時(shí)，有的銀行會(huì)校驗(yàn)用戶一類卡的預(yù)留手機(jī)號(hào)，如果不一致或者查詢不到，就會(huì)禁止綁卡。
● 服務(wù)商在接入銀行時(shí)，與銀行溝通放開手機(jī)號(hào)驗(yàn)證，避免后續(xù)用戶遇到這個(gè)問(wèn)題。
● 如果銀行不同意放開，當(dāng)用戶綁卡遇到該問(wèn)題，用戶可以輸入不同手機(jī)號(hào)嘗試綁卡，或者聯(lián)系銀行更換預(yù)留的手機(jī)號(hào)。
● 服務(wù)商可以調(diào)用接口，允許無(wú)法綁卡的用戶放棄綁卡，降級(jí)為非指定卡完成簽約。

（3）用戶綁卡時(shí)，返回查詢卡號(hào)失敗？
● 用戶指定卡簽約，服務(wù)商調(diào)用預(yù)簽約接口時(shí)建議傳入銀行卡類型。
● 銀行的新增卡號(hào)字段需同步給微信支付側(cè)接口人，財(cái)付通添加，未添加的卡號(hào)字段，將導(dǎo)致綁卡失敗。

（4）銀行返回的綁卡失敗文案，用戶難理解？
● 服務(wù)商接入銀行時(shí)，需獲得銀行錯(cuò)誤碼列表并同步給微信支付側(cè)接口人，共同完善用戶指引。

（5）在一個(gè)時(shí)間段內(nèi)大量訂單代扣失敗？
● 請(qǐng)?zhí)崆芭c銀行溝通、確定銀行系統(tǒng)維護(hù)時(shí)段，避免這些時(shí)段發(fā)起代扣。
● 請(qǐng)確定銀行網(wǎng)絡(luò)抖動(dòng)的時(shí)間，和銀行核實(shí)情況，待銀行系統(tǒng)恢復(fù)。

（6）指定卡簽約有卡類型限制？
● 指定卡簽約，微信支付側(cè)不限制卡類型，借記卡、信用卡均可簽約。
詳細(xì)內(nèi)容可查閱指定卡問(wèn)題和措施。

# 3.5 簽約狀態(tài)變更回調(diào)

服務(wù)商為學(xué)校開發(fā)基于師生的用戶管理體系時(shí)，需要維護(hù)用戶的采集和簽約狀態(tài)，并同步至刷臉設(shè)備。服務(wù)商只能獲取用戶簽約信息，不能獲取用戶解約信息，導(dǎo)致服務(wù)商無(wú)法維護(hù)用戶狀態(tài)，需要服務(wù)商進(jìn)行申請(qǐng)配置回調(diào)通知，刷臉用戶在完成簽約或解約后，微信會(huì)通知商戶用戶簽約狀態(tài)變更。服務(wù)商需要接收處理，并返回應(yīng)答。

申請(qǐng)流程如下，填寫表格發(fā)送給對(duì)應(yīng)郵箱，微信側(cè)會(huì)在2-3個(gè)工作日配置完成。
● 申請(qǐng)表模板請(qǐng)下載：【校園刷臉】申請(qǐng)用戶解約通知申請(qǐng)表
郵件發(fā)送：wxpay_edu@tencent.com
郵件抄送：kingsleycwu@tencent.com;ethantjli@tencent.com;zlxiang@tencent.com;v_ynfengliu@tencent.com;
主題格式：[申請(qǐng)用戶解約通知][服務(wù)商名稱][日期]
正文包括如下：
你好，我司申請(qǐng)XXXX（將表格內(nèi)容粘貼到正文里，勿以圖片形式呈現(xiàn)，即不要截圖）。
附件加上【校園刷臉】申請(qǐng)用戶解約通知申請(qǐng)表。

離線刷臉簽約狀態(tài)變更回調(diào)開發(fā)文檔：

接口規(guī)則
● 認(rèn)證方式：HTTPS協(xié)議，SHA256 with RSA進(jìn)行簽名。
● 返回和提交數(shù)據(jù)的簽名，商戶號(hào)，時(shí)間戳，隨機(jī)串等在HTTP頭中傳遞。
● 提交和返回結(jié)果采用JSON格式。
● 字符集默認(rèn)使用UTF-8，請(qǐng)勿使用其它字符集。
● 交互的返回和回調(diào)數(shù)據(jù)都需要校驗(yàn)簽名。
【離線刷臉回調(diào)通知-用戶簽約狀態(tài)變更通知 API】

應(yīng)用場(chǎng)景
刷臉用戶在完成簽約或解約后，微信會(huì)通知商戶用戶簽約狀態(tài)變更。商戶需要接收處理，并返回應(yīng)答。出于安全的考慮，我們對(duì)數(shù)據(jù)進(jìn)行加密，商戶需要先對(duì)通知數(shù)據(jù)進(jìn)行解密，才能得到用戶簽約狀態(tài)信息。

對(duì)后臺(tái)通知交互時(shí)，如果微信收到應(yīng)答不是成功或超時(shí)，微信認(rèn)為通知失敗，微信會(huì)通過(guò)一定的策略定期重新發(fā)起通知，盡可能提高通知的成功率，但微信不保證通知最終能成功。

注意：同樣的通知可能會(huì)多次發(fā)送給商戶系統(tǒng)，商戶系統(tǒng)必須能夠正確處理重復(fù)的通知。

推薦方式：當(dāng)商戶系統(tǒng)收到通知進(jìn)行處理時(shí)，先檢查對(duì)應(yīng)業(yè)務(wù)數(shù)據(jù)的狀態(tài)，并判斷該通知是否已經(jīng)處理。如果未處理，則再進(jìn)行處理；如果已處理，則直接返回結(jié)果成功。在對(duì)業(yè)務(wù)數(shù)據(jù)進(jìn)行狀態(tài)檢查和處理之前，要采用數(shù)據(jù)鎖進(jìn)行并發(fā)控制，以避免函數(shù)重入造成的數(shù)據(jù)混亂。

簽約狀態(tài)變更通知業(yè)務(wù)序列圖
簽約: 服務(wù)商可以通過(guò)簽約小程序引導(dǎo)用戶完成簽約，此時(shí)微信離線刷臉業(yè)務(wù)系統(tǒng)將會(huì)發(fā)送簽約變更狀態(tài)給到服務(wù)商提供的回調(diào)地址。

解約: 解約入口有兩個(gè)，一個(gè)是微信用戶通過(guò)微信客戶端發(fā)起解約，一個(gè)是商戶通過(guò)調(diào)用后臺(tái)API接口進(jìn)行解約。解約后，微信K12業(yè)務(wù)系統(tǒng)將發(fā)送簽約變更狀態(tài)給到服務(wù)商提供的回調(diào)地址。

以下是簽約通知狀態(tài)變更業(yè)務(wù)中，微信離線刷臉業(yè)務(wù)系統(tǒng)和商戶后臺(tái)系統(tǒng)交互的序列圖：

接口說(shuō)明
環(huán)境：正式環(huán)境
請(qǐng)求方式：post
請(qǐng)求地址：該鏈接由商戶提供，微信審核通過(guò)后上線。URL必須為https協(xié)議，如果鏈接無(wú)法訪問(wèn)，商戶將無(wú)法接收到微信通知。通知url必須為直接可訪問(wèn)的url，不能攜帶參數(shù)。示例：
notify_url：“https://api.yourcompany.com/notify/process.action”

請(qǐng)求參數(shù)

用戶簽約變更通知是以POST方法訪問(wèn)商戶設(shè)置的通知url，通知的數(shù)據(jù)以JSON格式通過(guò)請(qǐng)求主體（BODY）傳輸，通知的數(shù)據(jù)包括加密的支付結(jié)果詳情。
resource對(duì)象列表：

下面詳細(xì)描述對(duì)通知數(shù)據(jù)進(jìn)行解密的流程：
a. 用商戶平臺(tái)上設(shè)置的APIv3密鑰【微信商戶平臺(tái)—>賬戶設(shè)置—>API安全—>設(shè)置APIv3密鑰】，記為key。
b. 針對(duì)resource.algorithm中描述的算法（目前為AEAD_AES_256_GCM），取得對(duì)應(yīng)的參數(shù)nonce和associated_data。
c. 使用key、nonce和associated_data，對(duì)數(shù)據(jù)密文resource.ciphertext進(jìn)行解密，得到JSON形式的資源對(duì)象。
注意：AEAD_AES_256_GCM算法的接口細(xì)節(jié)，請(qǐng)參考rfc5116。微信支付使用的密鑰key長(zhǎng)度為32個(gè)字節(jié)，隨機(jī)串nonce長(zhǎng)度12個(gè)字節(jié)，associated_data長(zhǎng)度小于16個(gè)字節(jié)并可能為空。
解密后的resource對(duì)象列表：

{
	"user_id": "FUxxxfjeiofewfefw",
	"out_user_id": "fefwe33333333",
	"organization_id": "OPfefewwefwe",
	"mch_id": "1233456",
	"notify_create_time": "2020-05-20T10:23:14+08:00",
	"appid": "fefefewfefew",
	"openid": "fjeofejwofewfew"
}

通知簽名
加密不能保證通知請(qǐng)求來(lái)自微信。微信會(huì)對(duì)發(fā)送給商戶的通知進(jìn)行簽名，并將簽名值放在通知的HTTP頭Wechatpay-Signature。商戶應(yīng)當(dāng)驗(yàn)證簽名，以確認(rèn)請(qǐng)求來(lái)自微信，而不是其他的第三方。簽名驗(yàn)證的算法請(qǐng)參考《微信支付APIv3簽名方案》。

通知應(yīng)答
商戶后臺(tái)在正確處理回調(diào)之后，需要返回200或者204的HTTP狀態(tài)碼。其他的狀態(tài)碼，微信支付均認(rèn)為通知失敗，并按照前述的策略定期發(fā)起通知。注意，當(dāng)商戶后臺(tái)應(yīng)答失敗時(shí)，微信支付將記錄下應(yīng)答的報(bào)文，建議商戶按照如下格式返回。

應(yīng)答示例

{
	"code": "ERROR_NAME",
	"message": "ERROR_DESCRIPTION",
}

# 4. 落地實(shí)踐指導(dǎo)

# 4.1 現(xiàn)場(chǎng)安裝部署

4.1.1 設(shè)備安裝
微信刷臉支付團(tuán)餐設(shè)備安裝落地指南如下：

（1）安裝高度
● 食堂場(chǎng)景安裝高度：?攝像頭距離地面高度，建議1500 mm?，能覆蓋1.38～1.84米身高；
● 桌面收銀安裝高度：?攝像頭距離地面高度，建議1500 mm?，匹配支架，旋轉(zhuǎn)角度建議控制在20度之內(nèi)；
● 注意事項(xiàng)：?應(yīng)避免設(shè)備置于菜品水蒸氣正上方。

食堂場(chǎng)景

（2）易用性檢測(cè)

（3）功能檢測(cè)

（4）常見異常解決方案-軟件部分

（5）常見異常解決方案-硬件部分

（6）設(shè)備使用建議

4.1.2 網(wǎng)絡(luò)部署建議

（1）網(wǎng)絡(luò)連通

網(wǎng)絡(luò)環(huán)境需符合《微信刷臉支付網(wǎng)絡(luò)環(huán)境要求》，為了保障設(shè)備的實(shí)時(shí)通信，建議優(yōu)先使用有線網(wǎng)。

● 有線連接
推薦使用有線網(wǎng)，網(wǎng)線采用符合國(guó)家/行業(yè)標(biāo)準(zhǔn)的超五類雙絞線（CAT5e）、水晶頭，布線前需使用網(wǎng)絡(luò)測(cè)線儀測(cè)試通過(guò)，確保線序正確。
網(wǎng)線最大長(zhǎng)度不超過(guò)100米，最好在80米以內(nèi)，從交換機(jī)到刷臉設(shè)備中間的網(wǎng)線不得有接口、不能折死彎，不能被擠壓。
走線時(shí)需將網(wǎng)線和其他的強(qiáng)電布線分開，避免電磁干擾。建議將所有線纜使用PVC管或者線槽保護(hù)，保證美觀和安全。

● 移動(dòng)網(wǎng)絡(luò)4G連接
如果能夠確保實(shí)際場(chǎng)地中移動(dòng)或聯(lián)通的4G信號(hào)較好（信號(hào)再滿格）且穩(wěn)定，可采用4G通信的方式。
4G物聯(lián)網(wǎng)卡需符合國(guó)家物聯(lián)網(wǎng)管理規(guī)定，做實(shí)名認(rèn)證。

● Wi-Fi連接
如果因?yàn)閳?chǎng)地限制不得不用Wi-Fi，可以先根據(jù)實(shí)地勘測(cè)，優(yōu)先選擇5G頻段，如果場(chǎng)地中建筑的遮擋物較多，2.4G網(wǎng)絡(luò)會(huì)可能更優(yōu)。
Wi-Fi路由器盡量采用天花板吊裝方式，如場(chǎng)地空間較大，可采用符合支持漫游協(xié)議的mesh路由。注意金屬板、承重墻、玻璃對(duì)信號(hào)的阻擋或反射影響。
注意：當(dāng)安裝10臺(tái)以上設(shè)備時(shí)，不建議采用Wi-Fi連接。

（2）帶寬要求
● 網(wǎng)絡(luò)類型
關(guān)于接入網(wǎng)絡(luò)的出口，盡可能保證是獨(dú)享帶寬或者通過(guò)QoS做帶寬保障，因?yàn)橛行┬@網(wǎng)或者共享網(wǎng)絡(luò)是有域名過(guò)濾的，所以需要確保刷臉機(jī)與服務(wù)商后臺(tái)和微信后臺(tái)這個(gè)網(wǎng)絡(luò)的連通性是好的。

● 有線網(wǎng)絡(luò)部署
如下場(chǎng)景，需確保安裝后，單臺(tái)設(shè)備平均帶寬有2Mbps以上的上下行帶寬。同一局域網(wǎng)下，不能串聯(lián)三個(gè)以上的交換機(jī)，如果不得不采用多臺(tái)串聯(lián)，需采用Trunk模式，但是要注意避免產(chǎn)生環(huán)路。
當(dāng)安裝4臺(tái)以下設(shè)備時(shí)，可使用穩(wěn)定、能夠有20Mbps帶寬以上的共用網(wǎng)絡(luò)，采用簡(jiǎn)單網(wǎng)絡(luò)拓?fù)涞穆酚善髦苯舆B接即可。
當(dāng)安裝5臺(tái)～30臺(tái)設(shè)備時(shí)，可使用穩(wěn)定，能夠有100Mbps帶寬以上的共有網(wǎng)絡(luò)（需使用speedtest網(wǎng)絡(luò)測(cè)試工具進(jìn)行驗(yàn)證），并采用企業(yè)級(jí)路由器+管理交換機(jī)（1~4個(gè)）進(jìn)行網(wǎng)絡(luò)搭建。
當(dāng)安裝31臺(tái)以上的設(shè)備時(shí)，推薦使用100Mbps以上的專線網(wǎng)絡(luò)（需使用speedtest網(wǎng)絡(luò)測(cè)試工具進(jìn)行驗(yàn)證），并采用光貓+企業(yè)級(jí)路由器+企業(yè)級(jí)千兆管理交換機(jī)，組網(wǎng)時(shí)需針對(duì)每層樓劃分VLAN，有條件的情況下盡可能每臺(tái)刷臉設(shè)備劃分獨(dú)立VLAN。

● IP分配
當(dāng)使用有線網(wǎng)或者Wi-Fi配置時(shí)，IP地址分配，注意給設(shè)備分配單獨(dú)的網(wǎng)段，采用DHCP分配時(shí)，注意DHCP地址池需要足夠大，避免出現(xiàn)IP地址無(wú)法分配的情況。

（3）供電要求
● 不斷電要求
必須至少保證斷電3小時(shí)以上的供電，建議采用UPS電源。
建議將路由器、交換機(jī)、刷臉機(jī)采用UPS電源連接（即不間斷電源），當(dāng)遇到斷電時(shí)，能夠?qū)⑿铍姵氐碾娔芡ㄟ^(guò)逆變器切換轉(zhuǎn)換的方式繼續(xù)供電，保障業(yè)務(wù)連續(xù)性。

● 強(qiáng)電接線
每個(gè)窗口的刷臉機(jī)采用獨(dú)立插座，刷臉機(jī)所在的空氣開關(guān)（漏電保護(hù)開關(guān)）下，不接其他電氣設(shè)備，防止跳閘。
強(qiáng)電線路不與網(wǎng)線在同一線槽。

（4）網(wǎng)絡(luò)檢測(cè)方案
● 服務(wù)商APP開發(fā)改造
服務(wù)商在開發(fā)刷臉APP時(shí)，需要包括網(wǎng)絡(luò)檢測(cè)功能（暗碼方式進(jìn)入），當(dāng)發(fā)起網(wǎng)絡(luò)檢測(cè)時(shí)，需和后臺(tái)通信（盡可能模擬交易數(shù)據(jù)，最低限度是ping較大長(zhǎng)度數(shù)據(jù)包，確保測(cè)試準(zhǔn)確率），統(tǒng)計(jì)丟包情況、網(wǎng)絡(luò)速度，并反饋到APP實(shí)時(shí)顯示出來(lái)。

● 網(wǎng)絡(luò)測(cè)試要求
a. 當(dāng)網(wǎng)絡(luò)和刷臉機(jī)安裝完成后，所有設(shè)備同時(shí)在APP上開啟網(wǎng)絡(luò)測(cè)速功能（并發(fā)5分鐘），每臺(tái)設(shè)備的速度不低于200 K Byte/s，所有設(shè)備的丟包率不大于1%。
b. 當(dāng)網(wǎng)絡(luò)和刷臉機(jī)安裝完成后，在刷臉機(jī)上安裝微信提供網(wǎng)絡(luò)可用性檢測(cè)APP，完成所有網(wǎng)絡(luò)檢測(cè)，測(cè)試結(jié)果為pass。

● 刷臉實(shí)測(cè)要求
當(dāng)確保網(wǎng)絡(luò)測(cè)速結(jié)果符合要求之后，每臺(tái)設(shè)備進(jìn)行10次刷臉，從點(diǎn)擊刷臉到識(shí)別出學(xué)生賬號(hào)的時(shí)間，需在3秒之內(nèi)。

# 4.2 簽約及扣款指導(dǎo)

問(wèn)題：用戶因?yàn)榭劭钍?微信號(hào)丟失等、導(dǎo)致支付欠款，觸發(fā)服務(wù)商的賬戶凍結(jié)邏輯，學(xué)生無(wú)法刷臉就餐或消費(fèi)。
措施：終端、微信消息展示凍結(jié)原因和措施指引；一線人員提供數(shù)據(jù)工具、提升家長(zhǎng)引導(dǎo)服務(wù)能力。

4.2.1 學(xué)生刷臉界面：展示無(wú)法消費(fèi)原因

問(wèn)題: 學(xué)生刷臉后界面提示無(wú)法消費(fèi)，學(xué)生不知道原因、無(wú)法告訴家長(zhǎng)處理？
方案：根據(jù)微信側(cè)回傳的扣款失敗原因，在終端界面上展示對(duì)應(yīng)文案。

4.2.2 家長(zhǎng)公號(hào)消息：支付失敗和措施
問(wèn)題: 服務(wù)商公號(hào)消息內(nèi)容不清晰，家長(zhǎng)看不懂、還要再咨詢?nèi)斯た头?/font>
方案：根據(jù)不同刷臉扣款失敗的原因，及時(shí)向家長(zhǎng)推送通知，引導(dǎo)家長(zhǎng)及時(shí)解決問(wèn)題，避免影響親屬或子女正常使用刷臉扣費(fèi)服務(wù)。

方案介紹
(1) 因余額不足導(dǎo)致扣費(fèi)失敗的通知
當(dāng)刷臉消費(fèi)產(chǎn)生但余額不足時(shí)，通過(guò)微信支付官方賬號(hào)及時(shí)告知用戶余額不足的情況，引導(dǎo)用戶充值。
● 指定卡將明確展示該指定卡的尾號(hào)與銀行信息，方便用戶了解是哪張卡出現(xiàn)余額不足問(wèn)題。

（2）因支付方式異常導(dǎo)致扣費(fèi)失敗的通知
支付方式異常包括無(wú)可用支付方式、銀行卡異常、簽約異常與微信支付被凍結(jié)幾種不同情況。
● 無(wú)可用支付方式
可能是用戶解綁了指定卡或微信賬戶未添加銀行卡導(dǎo)致，將通過(guò)微信支付官方賬戶引導(dǎo)用戶重新綁卡。

a. 目前暫不支持通過(guò)點(diǎn)擊「立即綁卡」進(jìn)入綁卡頁(yè)面，請(qǐng)返回微信-【我】-【支付】-【錢包】-【銀行卡】進(jìn)行銀行卡的添加綁定。

● 銀行卡異常
因銀行卡狀態(tài)異常導(dǎo)致，將通過(guò)服務(wù)通知引導(dǎo)用戶聯(lián)系銀行客服解決。

● 簽約異常
因簽約人解除簽約導(dǎo)致扣費(fèi)失敗，將引導(dǎo)用戶進(jìn)行重新簽約。

● 微信支付被凍結(jié)
因簽約人微信支付賬戶被凍結(jié)導(dǎo)致扣費(fèi)失敗，將引導(dǎo)用戶根據(jù)官方指引解除支付限制。

異常類型	文案建議
零錢或銀行卡余額不足	微信零錢或銀行卡余額不足，請(qǐng)及時(shí)充值
指定卡不可用	簽約的銀行卡被解綁，請(qǐng)重新綁定
無(wú)可用支付方式	無(wú)可用的銀行卡，請(qǐng)?jiān)谖⑿胖刑砑鱼y行卡
墊資超過(guò)上限	微信零錢或銀行卡余額不足，請(qǐng)及時(shí)充值
支付憑證異常	支付異常，請(qǐng)讓食堂聯(lián)系技術(shù)人員解決
微信賬號(hào)異常	微信賬號(hào)異常，如果賬號(hào)被封控請(qǐng)聯(lián)系微信客服
銀行卡狀態(tài)異常	銀行卡無(wú)法扣費(fèi)，請(qǐng)聯(lián)系銀行客服
簽約異常	簽約的微信號(hào)已解約，請(qǐng)重新簽約
金額限制	交易金額超過(guò)限制
頻次限制	刷臉過(guò)于頻繁，請(qǐng)稍后重試

4.2.3 一線人員數(shù)據(jù)工具：實(shí)時(shí)查看學(xué)生代扣異常和措施建議
問(wèn)題: 收到家長(zhǎng)or學(xué)生咨詢后，駐校人員無(wú)法及時(shí)獲知原因，回復(fù)和處理效率低？
方案：使用官方提供的「落地小助手」，一線人員可以隨時(shí)查看學(xué)生欠款原因和建議。