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 城市银行及农商行
