# 錯(cuò)誤快查
1.青蛙設(shè)備下的收銀設(shè)備或者 青蛙APP模式開放設(shè)備提示 “商戶號(hào)無權(quán)限使用該付款碼”
標(biāo)準(zhǔn)版：
1.可先進(jìn)行解綁：設(shè)置-關(guān)于本機(jī)-綁定商戶號(hào)信息-重置設(shè)備綁定信息，重啟一下，重新配合收銀機(jī)激活綁定其他商戶號(hào)即可。
2.若上述步驟執(zhí)行依舊無效，確認(rèn)好青蛙設(shè)備商戶號(hào)信息是否與收銀設(shè)備匹配（如不清楚如何區(qū)分，提供青蛙設(shè)備序列號(hào)SN和一筆微信掃碼微信訂單號(hào)（42000開頭的）提供給群內(nèi)技術(shù)支持助手協(xié)助查詢。
開發(fā)版：
檢查請求getwxpayfaceauthinfo、getwxpayfacecode、facepay（micropay）三個(gè)請求中的商戶號(hào)參數(shù)是否一致。
2.刷臉界面啟動(dòng)彈窗報(bào)錯(cuò)“設(shè)備登錄聯(lián)網(wǎng)異常，提示聯(lián)系微信團(tuán)隊(duì)”
(-3)：2.14版本已取消提示，不影響支付
(-5)：設(shè)備簽名失敗 2.20版本已取消提示，不影響支付
(-9)：2.20版本已修復(fù)，不影響支付
(271369219)：機(jī)器時(shí)間異常，2.20版本已取消提示，不影響支付
(-10001)：初始化網(wǎng)絡(luò)鏈接過慢導(dǎo)致，2.14版本已修復(fù)
(33)： 網(wǎng)絡(luò)超時(shí)，檢查網(wǎng)絡(luò)連通性，比如防火墻，代理，移動(dòng)網(wǎng)絡(luò)欠費(fèi)等
刷臉中提示網(wǎng)絡(luò)錯(cuò)誤：
(-102)：2.12版本修復(fù)
(31)： 請求網(wǎng)絡(luò)超時(shí)
(271369225)： 風(fēng)控?cái)r截， 可聯(lián)微信團(tuán)隊(duì)
(271375364) ：后臺(tái)錯(cuò)誤， 重試可恢復(fù)
3.刷臉界面彈窗報(bào)錯(cuò)"硬件接口錯(cuò)誤，請聯(lián)系技術(shù)支持"
如有遇到該錯(cuò)誤提示，需先更新至2.12版本以上。如2.12版本以上還有相關(guān)錯(cuò)誤提示，先檢查后屏pos是否連接成功，以上都確認(rèn)后，還是出現(xiàn)錯(cuò)誤。聯(lián)系技術(shù)支持。
4.刷臉界面彈窗報(bào)錯(cuò)"交易已提交，退出后查看訂單狀態(tài)，如狀態(tài)仍不明確，請與商家聯(lián)系" 錯(cuò)誤碼：271378475
- 請先確定正確調(diào)用后端支付接口進(jìn)行支付，鏈接：(http://www.tg885.com/wiki/doc/wxfacepay/develop/backend.html)
- 如確認(rèn)正確調(diào)用可重試，如多次出現(xiàn)該情況，可向微信技術(shù)支持團(tuán)隊(duì)反饋
5.刷臉界面彈窗報(bào)錯(cuò)"攝像頭異常，請重啟設(shè)備后重試 錯(cuò)誤碼：271378577"
攝像頭打開失敗，請確認(rèn)設(shè)備硬件鏈接是否正常。如后續(xù)還是報(bào)錯(cuò)，直接報(bào)修給廠商，安排上門維修。
6.刷臉界面彈窗報(bào)錯(cuò)"暫不支持此認(rèn)證模式"
1.先確認(rèn)SDK版本是否大于2.14
2.商戶號(hào)未開通延遲支付，請聯(lián)系運(yùn)營確認(rèn)申請開通情況。
7.刷臉界面彈窗報(bào)錯(cuò)"為保障此賬號(hào)安全，暫無法使用刷臉支付，請改用掃碼支付 錯(cuò)誤碼：271382694
你好，這是保護(hù)該用戶的合法權(quán)益，認(rèn)為存在風(fēng)險(xiǎn)時(shí)暫停提供人臉相關(guān)服務(wù)，建議使用其他支付方式
8.展會(huì)期間，刷臉界面彈窗報(bào)錯(cuò)"為保障此賬號(hào)安全，暫無法使用刷臉支付，請改用掃碼支付 錯(cuò)誤碼：271382694
你好，這是保護(hù)該用戶的合法權(quán)益，因?yàn)檎箷?huì)期間人流量較多，認(rèn)為存在安全支付風(fēng)險(xiǎn)，暫停提供人臉相關(guān)服務(wù)，建議使用其他支付方式。
展會(huì)期間，為了有個(gè)更好的用戶體驗(yàn)環(huán)境，商戶側(cè)可以提前申請風(fēng)控?cái)r截白名單，郵件發(fā)送設(shè)備序列號(hào)和展會(huì)時(shí)間至facepay_help@tencent.com
9.刷臉界面彈窗報(bào)錯(cuò)"認(rèn)證信息解析錯(cuò)誤" 錯(cuò)誤碼：271378435
參數(shù)解析錯(cuò)誤，需要檢查一下請求參數(shù)。如getwxpayfaceauthinfo接口
10.刷臉界面彈窗報(bào)錯(cuò)"設(shè)備認(rèn)證信息不能為空" 錯(cuò)誤碼：271378433
authinfo為空導(dǎo)致。檢查設(shè)備本地時(shí)間是否與當(dāng)前設(shè)備時(shí)間一致。檢查請求getwxpayfaceauthinfo是否獲取成功，參數(shù)信息是否有誤。清除緩存。
11.facecode接口：服務(wù)商商戶號(hào)未開通該產(chǎn)品的受理權(quán)限
服務(wù)商商戶號(hào)未開通權(quán)限。
12.facepay接口返回：facecode業(yè)務(wù)信息不匹配
方法1：檢查getwxpayfaceauthinfo、getwxpayfacecode、facepay（micropay）三個(gè)請求接口中的商戶號(hào)，appid，訂單號(hào)是否一致
方法2：設(shè)備跑出廠檢測后更換APP場景，如由 青蛙app/sdk 出廠后更換sdk/青蛙app使用刷臉，出現(xiàn)報(bào)錯(cuò)“業(yè)務(wù)信息不匹配” ，需通過郵件報(bào)備處理
13.識(shí)別彈窗提示刷臉識(shí)別遇到錯(cuò)誤，請掃碼支付或者重新支付 錯(cuò)誤碼：271383602
時(shí)間戳問題。本地時(shí)間跟設(shè)備時(shí)間不匹配導(dǎo)致
14.進(jìn)行刷臉識(shí)別，返回?cái)z像頭打開失敗【-6】no device found。錯(cuò)誤碼：271378465
先檢查設(shè)備連接線是否插穩(wěn)，重啟設(shè)備，確認(rèn)是否還提示彈窗，如必現(xiàn)，請聯(lián)系廠商報(bào)修。
15.商戶反饋進(jìn)行刷臉識(shí)別提示刷臉SDK初始化 返回碼：-4 271377942
重新init一次，如無效聯(lián)系技術(shù)人員
16.facepay（micropay）接口返回ip address is null
本機(jī)沒有ip地址，通常是因?yàn)槲茨苈?lián)網(wǎng)。
17.出廠檢查工具數(shù)據(jù)查詢接口，返回?cái)?shù)據(jù)：{"code":"RESOURCE_NOT_EXISTS","message":"商戶沒有綁定設(shè)備SN前綴"}
我們對檢查設(shè)備的數(shù)據(jù)有鑒權(quán)保護(hù)，防止數(shù)據(jù)泄露。請用公司郵箱，將商戶號(hào)和設(shè)備序列號(hào)前5位，發(fā)送到(bobymxiang@tencent.com)，我們會(huì)為你綁定。之后便可正常查詢。后續(xù)此流程會(huì)自動(dòng)化。
18.未能識(shí)別出你的身份，你可重新嘗試，或使用掃碼支付
可能存在以下幾個(gè)原因，排除后可嘗試重試：
- 請確認(rèn)輸入的手機(jī)號(hào)對應(yīng)的微信賬號(hào)實(shí)名確實(shí)為本人，可在“微信”-“我”-“支付”-右上角“...”-“實(shí)名認(rèn)證”內(nèi)查看微信賬號(hào)實(shí)名信息是否和本人一致。
- 請盡量正面面向攝像頭，確保臉部沒有頭發(fā)、帽子、眼鏡以及其他飾物遮擋。
- 實(shí)名認(rèn)證照片可能由于質(zhì)量問題，導(dǎo)致比對不通過。
- 檢查設(shè)備識(shí)別環(huán)境，陽光和燈光是否太亮或者太暗，燈光是否為彩色燈影響了用戶入像
19.調(diào)用getwxpayfaceauthinfo接口會(huì)返回商戶號(hào)和appid不匹配
商戶可自行前往 服務(wù)商平臺(tái) 中進(jìn)入營銷中心–支付后配置–appid
20.請求getwxpayfaceauthinfo接口返回請檢查mchid,submchid,appid,subappid等信息是否正確
多數(shù)報(bào)錯(cuò)為子商戶號(hào)未綁定subappid，可前往商戶平臺(tái)上確認(rèn)是否有綁定，如未綁定，可以刪除sub_appid參數(shù)進(jìn)行請求。如需要綁定可看此流程：服務(wù)商為特約商戶配置AppID（即sub_appid）操作指引。
21.用戶進(jìn)行刷臉支付提示刷臉支付遇到錯(cuò)誤，請掃碼支付或重新識(shí)別 錯(cuò)誤碼:271382016 (BASE64授權(quán)信息解碼失敗)
檢查getwxpayfacecode接口中，使用的authinfo參數(shù)，看一下是否修改了getwxpayfaceauthinfo獲取到的authinfo參數(shù)，如添加了換行符，修改了里面的符號(hào)
22.WINSDK版本。攝像頭異常，請重新識(shí)別或者使用掃碼支付271378480 攝像頭打開UVC失敗
模組分cplv3還是cplv5。當(dāng)前WIN1.16版本SDK不支持cplv5。需要等待1.18SDK發(fā)版之后才能支持
23.調(diào)用getWxpayfaceRawdata接口返回 ERROR | SN is invalid
因?yàn)閟n不符合規(guī)范，sn是由數(shù)字或字母組成的，不能為null，不能為unknown。具體的設(shè)備序列號(hào)規(guī)則可前往設(shè)備序列號(hào)規(guī)則
24.WIN版本的SDK啟動(dòng)人臉識(shí)別服務(wù)彈窗“wxpayfaceservice.exe-系統(tǒng)錯(cuò)誤”無法啟動(dòng)此程序，因?yàn)橛?jì)算機(jī)中丟失api-ms-win-crt-heap-|1-1-0.dll。嘗試重新安裝該程序已解決此問題。
1.14版本SDK需要額外安裝vcredist 。安裝入口
1.16版本后就不需要額外安裝vcredist了，或者可以升級(jí)到1.16版本以上。
25.請求getwxpayfaceauthinfo接口返回：無效的RawData數(shù)據(jù)
無效的rawdata數(shù)據(jù)的原因很多，最常見的是rawdata時(shí)間問題。其次是緩存問題，可以嘗試清除一次緩存，重啟測試。
這里的rawdata時(shí)間使用的是機(jī)器本地時(shí)間，所以機(jī)器時(shí)間也需要準(zhǔn)確。比請求時(shí)間快，或者比請求時(shí)間慢5分鐘都會(huì)遇到這個(gè)錯(cuò)誤。
26.V3接口進(jìn)行實(shí)名認(rèn)證返回Unable to get userauth info
確認(rèn)是否開通實(shí)名認(rèn)證的權(quán)限。權(quán)限跟行業(yè)對接運(yùn)營確認(rèn)。
27.進(jìn)行刷臉支付后，收銀設(shè)備提示：特約子商戶號(hào)未授權(quán)服務(wù)商的產(chǎn)品權(quán)限
權(quán)限未開通，或者使用錯(cuò)了商戶號(hào)請求。申請入口
28.進(jìn)行刷臉識(shí)別時(shí)，提示彈窗“交易額不能為空” 錯(cuò)誤碼：271378498
一般情況下為total_fee該參數(shù)單位為分。還有注意參數(shù)是否填寫錯(cuò)誤
29.調(diào)用getWxpayfaceRawdata方法， 返回 AES error 這個(gè)是什么原因?qū)е碌模?/strong>
安卓版本太低導(dǎo)致，請參考微信刷臉官方硬件要求。系統(tǒng)設(shè)計(jì)要求
30.獲取authinfo時(shí)遇到“生成authinfo失敗”
通常是由于rawdata我們無法解析導(dǎo)致的。
推薦檢查實(shí)際提交的rawdata和在機(jī)器上獲取的時(shí)候是否一致。常見的是里面插入了奇怪的換行符、把加號(hào)換成了空格等情況。
附：base64的合法字符表：
31.刷臉設(shè)備提示：device is root state dangerous！
從1.20版本開始。需要關(guān)閉設(shè)備root權(quán)限
32.2.12SDK版本前：刷臉支付提示本設(shè)備刷臉支付暫不可用，請改用掃碼支付 錯(cuò)誤碼：271373337。2.12SDK：設(shè)備不符合安全規(guī)范
設(shè)備打開了root，處于黑名單狀態(tài)，修改后申請恢復(fù)權(quán)限，咨詢微信工作人員。
33.接口返回Service Unconnected
需要重新進(jìn)行一次init初始化
34.設(shè)備在更新2.13版本后出現(xiàn)“設(shè)備SN發(fā)生異常替換，請聯(lián)系設(shè)備提供商 271378551”
清除WxFacePay緩存和數(shù)據(jù)，重啟
35.如果配了防火墻 長連接還不通
可以通過清空WxFacePay緩存&數(shù)據(jù)
36.本設(shè)備暫不可用刷臉支付，請改用掃碼支付 271373345
設(shè)備本身沒問題，刷臉失敗次數(shù)過多會(huì)觸發(fā)風(fēng)控，請引導(dǎo)商戶在光線、 攝像頭角度合理的環(huán)境下使用，最好正對攝像頭，杜絕同個(gè)人重復(fù)測試。
37.刷臉時(shí)提示“暫不支持此認(rèn)證模式”
使用了延遲支付模式(face_authtype = "FACEPAY_DELAY")，需先開通延遲支付權(quán)限，若已開通依舊提示，請等待段時(shí)間后重試，新設(shè)備下發(fā)配置需要時(shí)間。
38.刷臉時(shí)提示“設(shè)備不符合安全規(guī)范”
進(jìn)行出廠檢測后-恢復(fù)出廠設(shè)置-重啟。
39.獲取認(rèn)證憑證（face_code）失敗，return_msg：“AuthInfo Lincense Error”
確認(rèn)下rawdata是不是在同一臺(tái)機(jī)器上獲取的，如果切換了網(wǎng)卡，也需要重新獲取下rawdata，然后再去獲取facecode
建議用同一個(gè)網(wǎng)絡(luò)環(huán)境，重新走一遍getWxpayfaceRawdata、get_wxpayface_authinfo、getWxpayfaceCode的流程。
40.設(shè)備進(jìn)行出廠檢測提示“獲取測試商戶號(hào)信息錯(cuò)誤，請稍后重試”
檢查下設(shè)備時(shí)間（進(jìn)入設(shè)置-日期和時(shí)間，確保設(shè)備本身時(shí)間是正確的）和設(shè)備網(wǎng)絡(luò)是否正常。如無效聯(lián)系技術(shù)人員。
41.刷臉界面彈窗報(bào)錯(cuò)認(rèn)證失敗：-1"
authInfo問題，檢查下設(shè)備時(shí)間，重啟設(shè)備，然后重新初始化試下
42.Windows設(shè)備上screen_index設(shè)置擴(kuò)展屏幕，刷臉支付還是沒有到副屏上
剛從復(fù)制屏切換到擴(kuò)展屏，需要重啟下WxpayFaceService服務(wù)，不然無法讀取到多屏幕配置
43.出廠檢測提示“請求失敗，請確定網(wǎng)絡(luò)正常，設(shè)備時(shí)間正確后重啟”
1.檢查網(wǎng)絡(luò)是否正常，需要提供網(wǎng)絡(luò)檢測結(jié)果截圖（進(jìn)入設(shè)置頁，點(diǎn)擊網(wǎng)絡(luò)檢測，設(shè)置頁路徑：調(diào)起刷臉，點(diǎn)擊屏幕中上方數(shù)下進(jìn)入）
2.檢查設(shè)備時(shí)間與網(wǎng)絡(luò)時(shí)間是否一致
44.SDK模式下拉起刷臉支付耗時(shí)久
1.檢查一下在調(diào)用起刷臉支付之前，是否有在主線程做過多的耗時(shí)操作。如有請優(yōu)化這類耗時(shí)，可嘗試切換到子線程進(jìn)行；
2.如已排除1引起的問題，可在logcat查看關(guān)鍵日志ActivityTaskManager: Displayed com.tencent.wxpayface/.awesomesdk.SdkModeFrameActivity: +xxx ms,如xxx ms耗時(shí)大于1500ms，請聯(lián)系反饋給微信刷臉支付技術(shù)支持。
45.無人零售使用刷臉支付分設(shè)備提示“網(wǎng)絡(luò)超時(shí)，可重新刷臉或掃碼”
1.如設(shè)備為低版本更新到2.21.104版本，可清理設(shè)備系統(tǒng)應(yīng)用緩存和數(shù)據(jù)后重啟解決，或更新高版本SDK；
2.設(shè)備使用刷臉支付分功能的情況下，如有安裝IoTservice，注意是否為預(yù)置安裝，如手動(dòng)安裝，需清除IoTservice緩存。