银行卡归属地查询(bankcard_info)
<p>[TOC]</p>
<h5>产品描述</h5>
<ul>
<li>通过输入银行卡号,返回银行卡归属地等信息</li>
</ul>
<h5>接口地址</h5>
<ul>
<li>请求地址:<code>https://api.caih.com/verify/api/bankcard_info</code></li>
<li>请求方式:POST</li>
<li>接口数据类型:JSON</li>
<li>编码方式:UTF-8</li>
<li>接口参数传递位置:请求体body</li>
<li>接口参数传递内容:认证信息参数(authinfo)和校验请求参数(param)</li>
</ul>
<h5>接口须知</h5>
<ul>
<li><strong>认证信息参数</strong> 和 <strong>统一响应参数</strong>请查看页面 <a href="https://www.showdoc.cc/p/52021eddfd9994a7b84d891a16e27f66" title="认证信息参数和统一响应参数">认证信息参数和统一响应参数</a></li>
<li>如需加密对接请查看页面 <a href="https://www.showdoc.cc/p/dfff667dec3c68748dddde67674eb993" title="加密对接说明">加密对接说明</a>,并联系运营人员进行配置</li>
</ul>
<h5>校验请求参数(param)</h5>
<table>
<thead>
<tr>
<th>参数名</th>
<th>是否必填</th>
<th>类型</th>
<th><div style="width: 400px"/>说明</th>
</tr>
</thead>
<tbody>
<tr>
<td>bankcard</td>
<td>是</td>
<td>string</td>
<td>银行卡号,15位至19位</td>
</tr>
</tbody>
</table>
<h5>请求示例</h5>
<pre><code>{
(认证信息参数)
"param": {
"bankcard": "6214830105839012"
}
}</code></pre>
<h5>产品响应参数(data)</h5>
<p>查询状态码及描述请查看本页章节 <code>查询状态码及描述</code> 。</p>
<table>
<thead>
<tr>
<th>参数名</th>
<th>是否必填</th>
<th>类型</th>
<th><div style="width: 400px"/>说明</th>
</tr>
</thead>
<tbody>
<tr>
<td>state</td>
<td>是</td>
<td>string</td>
<td>查询状态码</td>
</tr>
<tr>
<td>desc</td>
<td>是</td>
<td>string</td>
<td>查询状态码描述</td>
</tr>
<tr>
<td>bank</td>
<td>否</td>
<td>string</td>
<td>银行名称</td>
</tr>
<tr>
<td>province</td>
<td>否</td>
<td>string</td>
<td>银行卡开户省</td>
</tr>
<tr>
<td>city</td>
<td>否</td>
<td>string</td>
<td>银行卡开户市</td>
</tr>
<tr>
<td>cardName</td>
<td>否</td>
<td>string</td>
<td>银行卡名称</td>
</tr>
<tr>
<td>tel</td>
<td>否</td>
<td>string</td>
<td>银行官方客服电话</td>
</tr>
<tr>
<td>type</td>
<td>否</td>
<td>string</td>
<td>银行卡类型</td>
</tr>
<tr>
<td>logo</td>
<td>否</td>
<td>string</td>
<td>银行logo</td>
</tr>
<tr>
<td>abbreviation</td>
<td>否</td>
<td>string</td>
<td>银联支付网关简码</td>
</tr>
<tr>
<td>cardBin</td>
<td>否</td>
<td>string</td>
<td>银行卡bin码</td>
</tr>
<tr>
<td>binDigits</td>
<td>否</td>
<td>string</td>
<td>银行卡bin码长度</td>
</tr>
<tr>
<td>cardDigits</td>
<td>否</td>
<td>string</td>
<td>银行卡号长度</td>
</tr>
<tr>
<td>isLuhn</td>
<td>否</td>
<td>boolean</td>
<td>是否支持luhn校验</td>
</tr>
<tr>
<td>weburl</td>
<td>否</td>
<td>string</td>
<td>银行官方网站</td>
</tr>
</tbody>
</table>
<h5>返回示例</h5>
<h6>查询成功</h6>
<pre><code>{
(统一响应参数)
"data": {
"state": "1",
"desc": "查询成功"
"bank": "中国建设银行",
"province": "广东省",
"city": "潮州市",
"cardName": "龙卡通",
"tel": "95533",
"type": "借记卡",
"logo": "http://pic.dataox.com.cn/jianshe.png",
"abbreviation": "CCB",
"cardBin": "621700",
"binDigits": 6,
"cardDigits": 19,
"isLuhn": true,
"weburl": "http://www.ccb.com/"
}
}</code></pre>
<h6>查询失败</h6>
<pre><code>{
(统一响应参数)
"data": {
"state": "0",
"desc": "查询失败"
}
}</code></pre>
<h5>查询状态码及描述</h5>
<table>
<thead>
<tr>
<th>查询状态码(state)</th>
<th>查询状态码描述(desc)</th>
<th>是否收费</th>
<th>说明</th>
</tr>
</thead>
<tbody>
<tr>
<td>0</td>
<td>查询失败</td>
<td>否</td>
</tr>
<tr>
<td>1</td>
<td>查询成功</td>
<td>是</td>
</tr>
</tbody>
</table>