## 银行卡三元素检测 ![](https://img.kancloud.cn/bd/5d/bd5de58838ab0ca16415d1b1d9230e01_216x152.png =x120) > 检测输入的姓名、身份证号码、银行卡号是否一致。 ## 接口费用([点击购买](https://market.topthink.com/product/69)) > 最低 0.25元/次 ## 接口调用([调用须知](https://docs.topthink.com/think-api/1835086)) >[danger] 建议对同一卡号查询做次数限制,分为连续错误次数限制和总请求次数限制两种,超过其中一种就会触发银联风控机制暂停调验。具体规则为连续错误3次,则第4次被锁定,当日总次数超过10次后锁定。恢复规则分为12h后恢复和次日0时恢复。锁定期间建议不要再反复提交,否者锁定时间会延长。另:若银行限制级别高于银联限制,则以银行限制要求为准。 ### 请求地址 ``` GET https://api.topthink.com/verifybankcard3/query ``` ### 请求参数 | 名称 | 必填 | 类型 | 说明 | | --- | --- | --- | --- | | appCode| 是 | string| 用户授权码,参考[API调用](https://docs.topthink.com/think-api/1835086) | | realname | 是 | string | 姓名 | | idcard | 是 | string | 身份证号码 | | bankcard | 是 | string | 银行卡卡号 | | uorderid | 否 | string | 用户订单号,8到32位数字字母组合,要保证唯一 | | isshow | 否 | int | 是否显示匹配信息,0默认不显示,1显示 | ### 返回参数 | 名称 | 类型 | 说明 | | --- | --- | --- | | bankcard | string | 银行卡卡号 | | realname | string | 姓名 | | idcard | string | 身份证号码 | | res | int | 匹配结果,1:匹配 2:不匹配 | | message | string | 只有参数isshow不为空且不为0时显示 | ## SDK调用 ``` $client = new Client("YourAppCode"); $result = $client->verifybankcard3Query() ->withRealname('姓名') ->withIdcard('身份证号码') ->withBankcard('银行卡号') ->request(); dump($result); ``` 返回示例: ~~~ { "message": "成功", "data": { "jobid": "JH2071191112162139847181e7", "bankcard": "*************", "realname": "***", "idcard": "***************", "res": 2, "message": "认证信息不匹配,银行卡无效" }, "code": 0 } ~~~