# 軟件類(lèi)

# 網(wǎng)絡(luò)環(huán)境

1. 使用刷臉支付需要什么網(wǎng)絡(luò)環(huán)境?

請(qǐng)查看網(wǎng)絡(luò)環(huán)境要求

# 接口問(wèn)題

1.接口返回："簽名錯(cuò)誤"

請(qǐng)按照以下幾點(diǎn)進(jìn)行排查：
1、使用簽名檢查工具（http://www.tg885.com/wiki/doc/api/micropay.php?chapter=20_1 ）校驗(yàn)簽名算法是否有誤
2、確認(rèn)秘鑰是否有誤（服務(wù)商模式使用服務(wù)商商戶(hù)號(hào)秘鑰，秘鑰是在商戶(hù)平臺(tái)配置，如果同一商戶(hù)號(hào)調(diào)用其它接口成功可排除是秘鑰問(wèn)題）
3、確認(rèn)接口實(shí)際的請(qǐng)求參數(shù)與生成簽名原串的參數(shù)一致，不能增加或缺少參數(shù)（可通過(guò)打印簽名原串進(jìn)行排查）
4、確認(rèn)參數(shù)的大小寫(xiě)，參數(shù)名與接口文檔一致
5、簽名原串的參數(shù)值使用原始值，不需要encode
6、接口需要使用UTF-8編碼，不支持UTF8非3字節(jié)編碼的字符，如+
7、openid是否對(duì)應(yīng)當(dāng)前調(diào)起授權(quán)的微信號(hào)
8、H5授權(quán)跳轉(zhuǎn)URL排查URL格式是否正確，如是否多了空格、車(chē)牌參數(shù)是否沒(méi)有進(jìn)行URL編碼轉(zhuǎn)義（注：車(chē)牌參數(shù)跳轉(zhuǎn)url中需要轉(zhuǎn)義，參與sign生成的時(shí)不需要）

2.調(diào)用startCodeScanner無(wú)響應(yīng)

更新至2.12版本。該版本也只有一個(gè)錯(cuò)誤提示：攝像頭打開(kāi)失敗。如覺(jué)得信息不夠完整，請(qǐng)反饋給技術(shù)支持

3.face_code_type=1返回的還不是刷卡付款碼：18位數(shù)字的問(wèn)題

安卓：確認(rèn)SDK是否更新至1.30版本以上。
win：確認(rèn)SDK是否更新至1.16版本以上。

4.face_code_type=1和face_code_type=0的區(qū)別是什么？

調(diào)用getWxpayfaceCode時(shí)，face_code_type = 0，face_code 使用舊版刷臉支付接口（facepay）完成支付
調(diào)用getWxpayfaceCode時(shí)，face_code_type = 1，face_code 使用付款碼支付/被掃支付接口（micropay）完成支付

5.v3接口怎么獲取用戶(hù)的unionId

如何查詢(xún)unionid：查詢(xún)unionid

6.win版本的SDK怎么旋轉(zhuǎn)攝像頭

Windows 1.18版本以上 攝像頭旋轉(zhuǎn)特性具體用法：
在調(diào)用initWxpayface的時(shí)候傳入camera_rotation字段：1為+90度，2為180度，3為-90度
實(shí)際中設(shè)備商需要注意的是，可能需要把攝像頭旋轉(zhuǎn)的同時(shí)做一點(diǎn)傾斜，要把人臉正對(duì)到攝像頭畫(huà)面中間

7.設(shè)備出廠檢測(cè)掃碼授權(quán)提示“IOT服務(wù)異常，請(qǐng)檢查IOT版本是否正確”

請(qǐng)確認(rèn)：
1、請(qǐng)集成官方最新IOT版本；
2、設(shè)備是否已是出廠狀態(tài)。

8.提示“未能識(shí)別出你的身份，請(qǐng)面向攝像頭重新識(shí)別”錯(cuò)誤碼：271382020

authinfo過(guò)期導(dǎo)致，建議每一個(gè)小時(shí)調(diào)用一次接口獲取。

# 體驗(yàn)優(yōu)化

# 商戶(hù)刷臉支付耗時(shí)優(yōu)化指引

針對(duì)商戶(hù)反饋調(diào)起刷臉較慢的問(wèn)題，微信刷臉支付團(tuán)隊(duì)進(jìn)行了排查，并提供以下的優(yōu)化建議。

1.請(qǐng)先檢查是否存在以下問(wèn)題：

1、是否存在每次刷臉就獲取authinfo？
2、商戶(hù)點(diǎn)擊支付按鈕到調(diào)用sdk之間是否夾雜商戶(hù)業(yè)務(wù)邏輯？

2.耗時(shí)建議優(yōu)化點(diǎn)：

1、緩存authInfo，避免頻繁獲取authInfo：
（1）排查發(fā)現(xiàn)，外部設(shè)備存在“每次刷臉都獲取authInfo，導(dǎo)致刷臉支付體驗(yàn)緩慢”的情況；
（2）authInfo具有時(shí)效性（55分鐘），在有效期內(nèi)，商戶(hù)不需要重復(fù)請(qǐng)求；
（3）建議商戶(hù)對(duì)authInfo進(jìn)行緩存，每55分鐘進(jìn)行更新。
2、啟動(dòng)耗時(shí)優(yōu)化：商戶(hù)點(diǎn)擊支付按鈕，需盡快調(diào)用sdk拉起刷臉頁(yè)面，避免夾雜商戶(hù)業(yè)務(wù)邏輯。
3、避免每次刷臉都調(diào)用releaseWxpayface、initWxpayface，導(dǎo)致人臉?lè)?wù)每次都要初始化，引起額外耗時(shí)。

3.authInfo緩存優(yōu)化指引

1、設(shè)計(jì)authInfo緩存以及更新策略，具體指引如下：

// authInfo緩存
public AuthInfoModel mCurAuthInfo = null;

// 調(diào)用API時(shí)觸發(fā)更新
// 觸發(fā)時(shí)機(jī)建議：間隔mCurAuthInfo.getExpiresIn()秒以?xún)?nèi)
public void updateAuthInfo(HashMap param, IAuthCallback callback){
    if(mCurAuthInfo== null || mCurAuthInfo過(guò)期){
        // 重新獲取authInfo進(jìn)行更新。
        requestAuthInfo(param, callback);
    }else{
        // 未過(guò)期并且有效，直接返回當(dāng)前authInfo
        callback.oGetAuthInfo(mCurAuthInfo)
    }
}

// 發(fā)請(qǐng)求獲取authInfo
public void requestAuthInfo(HashMap param, IAuthCallback callback){...}

2、詳細(xì)示例代碼可參考Demo中的AuthInfoManager實(shí)現(xiàn)，具體使用方式如下：

authInfo緩存管理類(lèi)，商戶(hù)可參考思路，結(jié)合自身業(yè)務(wù)實(shí)現(xiàn)。
AuthInfoModel - authInfo數(shù)據(jù)封裝類(lèi)，僅供參考，商戶(hù)可自行擴(kuò)展。
IAuthFetcher - authInfo獲取器接口，需要商戶(hù)實(shí)現(xiàn)authInfo獲取。
IAuthCallback - authInfo回調(diào)接口，僅供參考，商戶(hù)可自行擴(kuò)展。

// 1. 商戶(hù)實(shí)現(xiàn)authInfo請(qǐng)求實(shí)現(xiàn)類(lèi)
AuthInfoManager.getInstance().setAuthFetcher( IAuthFetcherImpl )
// 2. 定時(shí)調(diào)用updateAuthInfo進(jìn)行更新，有效期內(nèi)復(fù)用緩存，無(wú)網(wǎng)絡(luò)耗時(shí)
AuthInfoManager.getInstance().updateAuthInfo(map, new IAuthCallback(){...})

4.點(diǎn)擊支付按鈕-->調(diào)用getWxpayfaceCode之間耗時(shí)優(yōu)化指引

1、使用上述緩存Authinfo優(yōu)化后，從點(diǎn)擊支付按鈕到調(diào)用getWxpayfaceCode接口耗時(shí)在50ms以?xún)?nèi)比較合理，如下圖所示。

2、檢查或整改建議：點(diǎn)擊支付按鈕-->調(diào)用getWxpayfaceCode之間主線(xiàn)程不做耗時(shí)業(yè)務(wù)操作，如需執(zhí)行業(yè)務(wù)邏輯建議在啟動(dòng)刷臉之后或異步執(zhí)行。

5.releaseWxpayface接口使用規(guī)范

1、聚合支付情況下：每次啟動(dòng)刷臉都需要initWxpayface，刷臉結(jié)束后需要調(diào)用releaseWxpayface（釋放攝像頭供其他刷臉支付平臺(tái)調(diào)用）；
2、非聚合支付情況下：首次刷臉需要initWxpayface，刷臉結(jié)束后不需要調(diào)用releaseWxpayface，否則下次刷臉需要重新initWxpayface，影響啟動(dòng)耗時(shí)；初始化之后第二次刷臉可以直接調(diào)用getWxpayfaceCode啟動(dòng)刷臉（在保證authinfo有效的情況下）。