银行卡四元素校验
最后更新于：2022-04-02 08:16:33
## 银行卡四元素校验
> 通过传递姓名+身份证号码+手机号+银行卡卡号，校验信息是否一致。
> 毫秒级相应、直联保障，支持全国所有银联卡。
> 支持信息加密传输方式。
> 支持身份证、护照、港澳通行证等证件。
## 接口费用（[点击购买](https://market.topthink.com/product/70)）
> 最低 0.25元/次
## 接口调用（[调用须知](https://docs.topthink.com/think-api/1835086)）
>[danger] 建议对同一卡号查询做次数限制，分为连续错误次数限制和总请求次数限制两种，超过其中一种就会触发银联风控机制暂停调验。具体规则为连续错误3次，则第4次被锁定，当日总次数超过10次后锁定。恢复规则分为12h后恢复和次日0时恢复。锁定期间建议不要再反复提交，否者锁定时间会延长。另：若银行限制级别高于银联限制，则以银行限制要求为准。
### 请求地址
```
GET https://api.topthink.com/verifybankcard4/query
```
### 请求参数
| 名称 | 必填 | 类型 | 说明 |
| --- | --- | --- | --- |
| appCode| 是 | string| 用户授权码，参考[API调用](https://docs.topthink.com/think-api/1835086) |
| realname | 是 | string | 姓名 |
| idcard | 是 | string | 身份证号码 |
| bankcard | 是 | string | 银行卡卡号 |
| mobile | 是 | string | 手机号码 |
| uorderid | 否 | string | 用户订单号,8到32位数字字母组合，要保证唯一 |
### 返回参数
| 名称 | 类型 | 说明 |
| --- | --- | --- |
| bankcard | string | 银行卡卡号 |
| realname | string | 姓名 |
| idcard | string | 身份证号码 |
| res | string | 匹配结果，1:匹配 2:不匹配 |
| mobile | string | 手机号码 |
## SDK调用
```
$client = new Client("YourAppCode");
$result = $client->verifybankcard4Query()
->withRealname('姓名')
->withIdcard('身份证号码')
->withBankcard('银行卡号')
->withMobile('手机号码')
->request();
dump($result);
```
返回示例：
~~~
{
"message": "成功",
"data": {
"jobid": "JH2131191113105116991630Np",/*本次查询流水号*/
"realname": "****",/*姓名*/
"bankcard": "************",/*银行卡卡号*/
"idcard": ""************",/*身份证号码*/
"mobile": "***********",/*预留手机号码*/
"res": "2",/*验证结果，1:匹配 2:不匹配*/
"message": "认证信息不匹配"/*描述*/
},
"code": 0
}
~~~
';