## 銀行卡三四元素檢測（簡版）  > 該接口可以同時檢測銀行卡三四要素，檢測輸入的姓名、身份證號碼、銀行卡號及手機號（如果不傳則不驗證手機）是否一致。 ## 接口費用（[點擊購買](https://market.topthink.com/product/348)） > 最低 0.25元/次 ## 接口調用（[調用須知](https://docs.topthink.com/think-api/1835086)） >[danger] 建議對同一卡號查詢做次數限制，分為連續錯誤次數限制和總請求次數限制兩種，超過其中一種就會觸發銀聯風控機制暫停調驗。具體規則為連續錯誤3次，則第4次被鎖定，當日總次數超過10次后鎖定。恢復規則分為12h后恢復和次日0時恢復。鎖定期間建議不要再反復提交，否者鎖定時間會延長。另：若銀行限制級別高于銀聯限制，則以銀行限制要求為準。 ### 請求地址 ``` GET https://api.topthink.com/bankcard/auth ``` ### 請求參數 | 名稱 | 必填 | 類型 | 說明 | | --- | --- | --- | --- | | appCode| 是 | string| 用戶授權碼，參考[API調用](https://docs.topthink.com/think-api/1835086) | | name| 是 | string | 姓名 | | idNum | 是 | string | 身份證號碼 | | cardNo| 是 | string | 銀行卡卡號 | | mobile | 否 | string | 銀行預留手機號碼，限單個，僅支持國內號碼，11位 如果不傳就不驗證 | ### 返回參數 | 名稱 | 類型 | 說明 | | --- | --- | --- | | handleTime| string | 查詢時間 樣例：2018-04-09 15:05:01 | | result| string |認證結果。01：一致? 02：不一致? 03：認證不確定? 04：認證失敗。01、02收費 | | remark| string | 備注。樣例：信息認證未通過(驗證不一致) | | bankName| string| 銀行卡所屬銀行。樣例：招商銀行 | | cardType | string | 銀行卡類型 樣例：金穗借記卡 | | cardCategory| string| 銀行卡類別 樣例：借記卡 | | orderNo| string | 業務唯一流水號 | ## SDK調用 ``` $client = new Client("YourAppCode"); $result = $client->bankcardAuth() ->withName('姓名') ->withIdNum('身份證號碼') ->withCardNo('銀行卡號') ->withMobile('手機號') ->request(); dump($result); ``` 返回示例： ~~~ { "message": "成功", "data": { "orderNo": "011608306716436130", "handleTime": "2020-12-18 23:51:56", "result": "02", "remark": "信息認證未通過(驗證不一致)", "bankName": "招商銀行", "cardType": "一卡通(銀聯卡)", "cardCategory": "借記卡" }, "code": 0 } ~~~