银行卡三元素检测
最后更新于：2022-04-02 08:16:31
## 银行卡三元素检测
> 检测输入的姓名、身份证号码、银行卡号是否一致。
## 接口费用（[点击购买](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
}
~~~
';