银行卡号归属地查询接口

银行卡归属地API

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

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

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

V1版本接口针对原api.yinhangkadata.com老用户迁移,只需要后台修改成原来的APIKEY即可使用
V1.1版本在V1的基础上修改增加了GET提交 API接入相比V1版本更简单
V2版本不直接明文POST提交APIKEY,使用SHA256算法提交sign参数 具体请参考对接文档及示例代码

1: 接口提交URL 提交方式

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

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: 银行名称对应的编码

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

4:示例

URL: https://gsdapi.com/api/v1/BankCard
POST参数
card: 622202*****88888888 19位卡号
key: 5021eb********3c798a63fb 32位key值
以上参数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"}

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: 银行名称对应的编码

注:只有符合银联卡编码规则的借记卡才可以查询归属地【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"}

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: 银行名称对应的编码

注:只有符合银联卡编码规则的借记卡才可以查询归属地【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"}

V1版本 php curl 示例代码

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

V1.1版本 php curl 示例代码

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

V2版本 php curl 示例代码

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

银行名称对应的编码(仅支持归属地查询的银行)

icbc 工商银行
abc 农业银行
boc 中国银行
ccb 建设银行
ceb 光大银行
cgb 广发银行
cib 兴业银行
citic 中信银行
cmb 招商银行
cmbc 民生银行
comm 交通银行
hxb 华厦银行
psbc 邮储银行
spdb 浦发银行
bdl 大连银行
bosc 上海银行
cbhb 渤海银行
czb 浙商银行
jsb 江苏银行
hzb 杭州银行
nbcb 宁波银行
xacb 西安银行
hfb 恒丰银行
xmccb 厦门银行
qsb 齐商银行
sjb 盛京银行
bqd 青岛银行
lsb 临商银行
brz 日照银行
whccb 威海市商业银行
bwf 潍坊银行
hrxj 华融湘江银行
hkb 汉口银行
bdg 东莞银行
tf 四川天府银行
jlb 吉林银行
hrbb 哈尔滨银行
ljb 龙江银行
njcb 南京银行
fdb 富滇银行
xzbc 西藏银行
lzb 兰州银行
pab 平安银行
czyh 村镇银行
csyh 城市银行及农商行