验真平台API文档


银行卡归属地查询(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>

页面列表

ITEM_HTML