银行卡号归属地查询接口

银行卡归属地API

银行卡归属地数据库可识别国内2000+银行卡所属银行、卡种、卡类型、卡名称、银行官网、客服电话等基础信息查询,银行卡开户行归属地省市查询数据支持国内43家主流银行+国内所有村镇银行+部分城市农商行。

在线API申请 私有化部署服务

注册登录可获取免费银行卡归属地数据接口查询点数

V1.1版本在V1的基础上修改增加了GET提交 API接入相比V1版本更简单
V2版本不直接明文POST提交APIKEY,使用SHA256算法提交sign参数 具体请参考对接文档及示例代码

2024.03.19更新 增加卡BIN、银行LOGO图片(bin,logo)二个字段
2024.01.02更新 增加银行官网、客服电话、城市行政区划代码经纬度(url,phone,adcode,lng,lat)五个字段

1: 接口提交URL 提交方式

URL: https://gsdapi.com/api/v1.1/BankCard?key=******&card=******
提交方式: GET

2: 传递参数:card、key

card: 需要查询的银行卡号
key: 系统分配用户的APIkey值

3:返回数据字段说明

RESULT: 返回码 1查询成功 -1异常错误
MESSAGE: 返回码说明
bankname: 银行名称
oldbankname: 原银行名称(银行合并改名后原来的名称)
card: 查询的卡号
cardtype: 卡类型
cardname: 卡名称
cardlen: 卡号长度
cardtypenum: 借识卡/贷记(信用)卡识别码 1借记卡 0贷记(信用)卡
binlen: 卡bin长度
LUHN: 银行卡号编码规则 yes/no (yes:卡号符合银联卡编码 no:卡号不符合银联卡编码 可能输错或者乱写)
province: 省份
city: 城市
bank_abc: 银行名称对应的编码
url: 银行官网
bin: 银行卡BIN码
logo: 银行LOGO
phone: 银行客服电话
adcode: 行政区划代码(返回归属地城市或省份行政区划代码)
lng: 返回归属地城市经度
lat: 返回归属地城市纬度

注:只有符合银联卡编码规则的借记卡才可以查询归属地【cardtypenum=1 LUHN=yes】

4:示例

URL: https://gsdapi.com/api/v1.1/BankCard?key=5021eb********3c798a63fb&card=622202*****88888888
GET参数
card: 622202*****88888888 19位卡号
key: 5021eb********3c798a63fb 32位key值

5:返回json

{"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加密码方法

加密使用了SHA256算法
加密字符串为:用户ID(uid)+当前时间(time)+用户KEY(APIkey) 连接拼成的长字符串
示例:uid=1000012345
time=20211208101858(注:2021-12-08 10:18:58 去掉时间当中的- :)
apikey=145b9c7f6aa67377bb664521007079a9
拼接后的字符串uid+time+apikey:100001234520211208101858145b9c7f6aa67377bb664521007079a9
sha256加密后字符:67bec755ce5704222a4ece083493dd3d54686281f4a80b83e1de277b860f34a3

1: 接口提交URL 提交方式

URL: https://gsdapi.com/api/v2/BankCard
提交方式: POST

2: 传递参数:uid、time、sign、card

uid: 系统分配的用户ID
time: 当前提交接口查询的时间(年月日时分秒)
sign: sign加密字符串(详见sign加密方法)
card: 需要识别的银行卡号

3:返回数据字段说明

RESULT: 返回码 1查询成功 0查无记录 -1异常错误
MESSAGE: 返回码说明
bankname: 银行名称
oldbankname: 原银行名称(银行合并改名后原来的名称)
card: 查询的卡号
cardtype: 卡类型
cardname: 卡名称
cardlen: 卡号长度
cardtypenum: 借识卡/贷记(信用)卡识别码 1借记卡 0贷记(信用)卡
binlen: 卡bin长度
LUHN: 银行卡号编码规则 yes/no (yes:卡号符合银联卡编码 no:卡号不符合银联卡编码 可能输错或者乱写)
province: 省份
city: 城市
bank_abc: 银行名称对应的编码
url: 银行官网
bin: 银行卡BIN码
logo: 银行LOGO
phone: 银行客服电话
adcode: 行政区划代码(返回归属地城市或省份行政区划代码)
lng: 返回归属地城市经度
lat: 返回归属地城市纬度

注:只有符合银联卡编码规则的借记卡才可以查询归属地【cardtypenum=1 LUHN=yes】

4:示例

URL: https://gsdapi.com/api/v2/BankCard
POST参数
uid=1000012345
time=20211208101858(注:2021-12-08 10:18:58 当前查询时间去掉时间当中的- :)
sign=67bec755ce5704222a4ece083493dd3d54686281f4a80b83e1de277b860f34a3
card=622202*****88888888 19位卡号
以上参数POST form-data是数组

5:返回json

{"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"}

V1.1版本 php curl 示例代码

替换以下代码中的card、key 值即可

V2版本 php curl 示例代码

替换以下代码中的card、uid、time、sign 值即可