## 银行卡三四元素检测（详版）  > 该接口可以同时检测银行卡三四要素，检测输入的姓名、身份证号码、银行卡号及手机号（如果不传则不验证手机）是否一致，并返回不一致详情。 ## 接口费用（[点击购买](https://market.topthink.com/product/349)） > 最低 0.35元/次 ## 接口调用（[调用须知](https://docs.topthink.com/think-api/1835086)） >[danger] 建议对同一卡号查询做次数限制，分为连续错误次数限制和总请求次数限制两种，超过其中一种就会触发银联风控机制暂停调验。具体规则为连续错误3次，则第4次被锁定，当日总次数超过10次后锁定。恢复规则分为12h后恢复和次日0时恢复。锁定期间建议不要再反复提交，否者锁定时间会延长。另：若银行限制级别高于银联限制，则以银行限制要求为准。 ### 请求地址 ``` GET https://api.topthink.com/bankcard/auth_detail ``` ### 请求参数 | 名称 | 必填 | 类型 | 说明 | | --- | --- | --- | --- | | appCode| 是 | string| 用户授权码，参考[API调用](https://docs.topthink.com/think-api/1835086) | | name| 是 | string | 姓名 | | idNum | 是 | string | 身份证号码 | | cardNo| 是 | string | 银行卡卡号 | | mobile | 否 | string | 银行预留手机号码，限单个，仅支持国内号码，11位 如果不传则不验证 | ### 返回参数 | 名称 | 类型 | 说明 | | --- | --- | --- | | handleTime| string | 查询时间 | | result| string | 认证结果代码。01:认证一致02:认证不一致03:认证不确定04:认证失败05:手机号码不匹配06:身份证号码不匹配07:姓名不匹配 01, 02, 05, 06, 07收费，其他不收费 | | remark| string | 备注。样例：信息认证未通过(验证不一致) | | bankName| string| 银行卡所属银行。样例：招商银行 | | cardType | string | 银行卡类型 样例：金穗借记卡 | | cardCategory| string| 银行卡类别 样例：借记卡 | | orderNo| string | 业务唯一流水号 | ## SDK调用 ``` $client = new Client("YourAppCode"); $result = $client->bankcardAuthDetail() ->withName('姓名') ->withIdNum('身份证号码') ->withCardNo('银行卡号') ->withMobile('手机号') ->request(); dump($result); ``` 返回示例： ~~~ { "message": "成功", "data": { "orderNo": "011608306716436130", "handleTime": "2020-12-18 23:51:56", "result": "07", "remark": "姓名不匹配", "bankName": "招商银行", "cardType": "一卡通(银联卡)", "cardCategory": "借记卡" }, "code": 0 } ~~~