## 人臉核身 > 通過支付寶或微信掃碼進行人臉實名認證。  >[danger]### 無論是網站、小程序還是APP客戶端，在運營過程中，都會面臨國內的互聯網監管壓力，這個時候對用戶進行實名認證是必備功能，`ThinkAPI`最新推出的人臉核身接口可以最大程度的簡化開發工作，通過優雅SDK一鍵對接支付寶和微信實人認證，而且比直接使用支付寶或微信官方的認證更具高性價比。 ## 功能介紹 1. 通過傳遞姓名+身份證號碼返回認證地址，用戶可以生成二維碼進行掃碼認證，認證結果可以異步回調或主動查詢 2. 支持支付寶和微信 3. 支持網站、H5、App和小程序 4. 適用于社區、電商、游戲、直播、金融等需要用戶實名認證的場景。 ## 認證流程 1. 傳遞用戶姓名和身份證號碼（這一環節可以通過身份證OCR識別或用戶輸入的方式獲取） 2. 調用接口生成支付寶或微信認證地址 3. 根據認證地址生成二維碼展示在頁面或App客戶端 4. 用戶打開支付寶或微信掃碼完成實人認證 5. 通過異步回調或主動查詢接口查詢認證接口 ## 接口1：認證地址生成 用戶輸入自己的身份證姓名和身份證號碼，選擇（支付寶/微信）模式后調用該接口，接口返回認證鏈接，用戶通過該鏈接進行刷臉認證 ### 接口費用 （[點擊購買](https://market.topthink.com/product/495)） > 最低 0.42元/次 > ### 請求地址 ``` GET https://api.topthink.com/face/detect ``` ### 請求參數 | 名稱 | 必填 | 類型 | 說明 | | --- | --- | --- | --- | | appCode| 是 | string|用戶授權碼，參考[API調用](https://docs.topthink.com/think-api/1835086) | | idcard | 是 |string|身份證號（大陸二代身份證） | | name | 是 |string|姓名 | | callbackUrl | 是 |string|認證成功后重定向地址，網頁端接入可以直接傳入網頁地址，app接入傳入app schema地址 | | notifyUrl | 是 |string|認證結束后異步通知接口,具體見異步通知說明 | | faceauthMode | 是 |string|**ZHIMACREDIT**?支付寶認證 **WECHAT**?微信認證（生成只有微信客戶端可以打開的鏈接） | >[danger] 支付寶里傳了`callbackUrl`時，認證完成后會跳出支付寶，打開一個外部瀏覽器打開`callbackUrl`，如果希望避免跳出支付寶的話，可以傳一個不存在的`schema`地址。 ### 返回`data`參數 | 請求參數 | 參數說明 | 示例 | | --- | --- | --- | | orderNumber | 認證業務訂單號 | b2f526e4e60ee4c48e880a798e65e96a | | requestId | 請求記錄ID | ER20221223113141254085 | | status | 初步認證狀態 | true | | originalUrl | 獲取個人刷臉實名認證長鏈接。可以自己生成短網址避免二維碼生成數據太多 | [https://open.weixin.qq.com/connect/oauth2/authorize?appid=wx1f7125112b74db52&redirect\_uri=https%3A%2F%2Fopen.faceid.qq.com%2Fv1%2Fapi%2FCode%3FbizRedirect%3Dhttps%253A%252F%252Ffaceid.qq.com%252Fapi%252Fauth%252FgetOpenidAndSaveToken%253Ftoken%253D7FBAF4F7-4F1A-4561-9937-C852E623763A&response\_type=code&scope=snsapi\_base&state=&component\_appid=wx9802ee81e68d6dee#wechat\_redirect](https://open.weixin.qq.com/connect/oauth2/authorize?appid=wx1f7125112b74db52&redirect_uri=https%3A%2F%2Fopen.faceid.qq.com%2Fv1%2Fapi%2FCode%3FbizRedirect%3Dhttps%253A%252F%252Ffaceid.qq.com%252Fapi%252Fauth%252FgetOpenidAndSaveToken%253Ftoken%253D7FBAF4F7-4F1A-4561-9937-C852E623763A&response_type=code&scope=snsapi_base&state=&component_appid=wx9802ee81e68d6dee#wechat_redirect) | | expire | 鏈接失效時間,毫秒值 結果依據實際的刷臉方式為準：**支付寶 30分鐘 微信 2小時** | 1671773501745 | >[danger] 建議保存返回的`orderNumber`數據，便于后期回調或查詢處理認證結果。 ### SDK調用 ``` $client = new Client("YourAppCode"); $result = $client->faceDetect() ->withIdcard('身份證號碼') ->withName('真實姓名') ->withCallbackUrl('認證成功后重定向地址') ->withNotifyUrl('異步通知回調地址') ->withFaceauthMode('ZHIMACREDIT') ->request(); dump($result); ``` 返回數據示例： ``` { "code": 0, "data": { "orderNumber": "45d35c36e36dfe9938jh9115c32a387a", "requestId": "ER20221223113141254502", "status": true, "originalUrl": "https://open.weixin.qq.com/connect/oauth2/authorize?appid=wx1f7125112b74db52&redirect_uri=https%3A%2F%2Fopen.faceid.qq.com%2Fv1%2Fapi%2FgetCode%3FbizRedirect%3Dhttps%253A%252F%252Ffaceid.qq.com%252Fapi%252Fauth%252FgetOpenidAndSaveToken%253Ftoken%253D7FBAF4F7-4F1A-4561-9937-C852E6238523A&response_type=code&scope=snsapi_base&state=&component_appid=wx9802ee81e68d6dee#wechat_redirect", "expire": "1671773501745" }, "message": "Success" } ``` >[danger] 返回`code`為0時計費。 ### 異步通知說明 認證業務在認證流程成功結束或失敗時（實名認證成功觸發異步通知），會通過流程發起時指定的notifyUrl參數，向調用方發送異步通知。 目前通過HTTP協議，以POST方法進行通知調用； 開發者對于異步回調通知只需通過POST方式進行接收即可，認證結果以實際POST方式接收的異步通知為準。 **通知參數如下**： application/json;charset=UTF-8 | 請求參數 | 類型 | 參數說明 | | --- | --- | --- | | requestId | String | 請求業務ID | |orderNumber|String| 業務訂單號| | isSuccess | Boolean | 認證結果：true、認證成功； false 、認證失敗 | ## 接口2：查詢認證結果 根據用戶輸入認證業務訂單號查詢認證結果 ### 請求地址 ``` GET https://api.topthink.com/face/query ``` ### 請求參數： | 請求參數 | 參數說明 | 示例 | 是否必填 | | --- | --- | --- | --- | | orderNumber | 認證業務訂單號 | b2f526e4e60ee4c48e880a798e65e96a | 是 | ### 返回參數： | 請求參數 | 參數說明 | 示例 | | --- | --- | --- | | name | 姓名 | 張三 | | idcard | 身份證 | 331081158456138512 | | status | 認證狀態 | 0：認證中；1：認證成功‘2：認證不匹配’ | ## SDK調用 ``` $client = new Client("YourAppCode"); $result = $client->faceQuery() ->withOrderNumber('b2f526e4e60ee4c48e880a798e65e96a') ->request(); dump($result); ``` ### 返回示例： ``` { ????"code":?"0", ????"data":?{ ????????"status":?1, ????????"name":?"張三", ????????"idcard":?"331081158456138512" ????}, ????"message":?"認證成功" } ```