银行卡归属地查询接口
银行卡归属地数据库可识别国内2000+银行卡所属银行、卡种、卡类型、卡名称、银行官网、客服电话等基础信息查询，银行卡开户行归属地省市查询数据支持国内43家主流银行+国内所有村镇银行+部分城市农商行。
文档概述
版本说明
- v2.0（key密文）：sign由key+参数拼接 SHA256算法加密后的密文参数
- v1.1（明文key）：接入简单,GET请求,URL后面key参数是明文,容易造成KEY泄露
接入说明
- 所有接口 GET/POST 请求（GET：key明文 / POST：key+其它参数拼接加密）
- 请求格式：form-data表单数组，响应格式：JSON
-
接口域名：
https://gsdapi.com
接口参数详情
接口地址：
https://gsdapi.com/api/v2/BankCard
请求方式：
POST
请求参数
| 参数名 | 类型 | 是否必选 | 说明 |
|---|---|---|---|
| uid | String | 是 | 系统分配的用户ID |
| time | String | 是 | 当前提交接口查询的时间（年月日时分秒） |
| sign | String | 是 | sign加密字符串（详见sign加密方法） |
| card | String | 是 | 需要查询的银行卡号 |
响应参数
| 参数名 | 类型 | 说明 |
|---|---|---|
| RESULT | Integer | 返回码 1查询有结果 0查询无结果 -1异常错误 |
| MESSAGE | String | 返回码说明 |
| bankname | String | 银行名称 |
| oldbankname | String | 原银行名称(此字段2024-06-16暂停) |
| card | String | 查询的卡号 |
| cardtype | String | 卡类型 |
| cardname | String | 卡名称 |
| cardlen | Integer | 卡号长度 |
| cardtypenum | Integer | 借识卡/贷记(信用)卡识别码 1借记卡 0贷记(信用)卡 |
| binlen | Integer | 卡bin长度 |
| LUHN | String | 银行卡号编码规则 yes/no (yes:卡号符合银联卡编码 no:卡号不符合银联卡编码 可能输错或者乱写) |
| province | String | 归属地省份 |
| city | String | 归属地城市 |
| bank_abc | String | 银行名称对应的编码 |
| url | String | 银行官网 |
| bin | String | 银行卡BIN码 |
| logo | String | 银行LOGO |
| phone | String | 银行客服电话 |
| adcode | String | 行政区划代码(返回归属地城市或省份行政区划代码) |
| lng | String | 返回归属地城市经度 |
| lat | String | 返回归属地城市纬度 |
请求示例
uid=1000012345 time=20211208101858(注：2021-12-08 10:18:58 当前查询时间去掉时间当中的- :) sign=67bec755ce5704222a4ece083493dd3d54686281f4a80b83e1de277b860f34a3 card=622202*****88888888 19位卡号 以上参数POST form-data是数组
响应示例
{{
"RESULT": "1",
"MESSAGE": "查询成功",
"card": "622202*****88888888",
"bankname": "工商银行",
"oldbankname": "",
"cardtype": "借记卡",
"cardname": "E时代卡",
"cardlen": "19",
"cardtypenum": "1",
"binlen": "6",
"LUHN": "yes",
"province": "广东省",
"city": "广州",
"bank_abc": "icbc",
"phone": "95588",
"url": "www.icbc.com.cn",
"adcode": "440100",
"lng": "113.264434",
"lat": "23.129162"
}
sign拼接加密说明
sign拼接加密码方法
加密使用了SHA256算法
加密字符串为:用户ID(uid)+当前时间(time)+用户KEY(APIkey) 连接拼成的长字符串
示例：uid=1000012345
time=20211208101858(注：2021-12-08 10:18:58 去掉时间当中的- :)
apikey=145b9c7f6aa67377bb664521007079a9
拼接后的字符串uid+time+apikey：100001234520211208101858145b9c7f6aa67377bb664521007079a9
sha256加密后字符:67bec755ce5704222a4ece083493dd3d54686281f4a80b83e1de277b860f34a3