银行卡三四要素简版
最后更新于：2022-04-02 08:16:35
## 银行卡三四元素检测（简版）
> 该接口可以同时检测银行卡三四要素，检测输入的姓名、身份证号码、银行卡号及手机号（如果不传则不验证手机）是否一致。
## 接口费用（[点击购买](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
}
~~~
';