村镇银行对公账户开户行归属地查询接口

村镇银行对公账号开户行归属地API

村镇银行对公账号归属地数据支持全国1400多家村镇银行对公账户所属银行及开户行归属地省市查询。

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

2024.05.11更新 请求参数新增一个企业名称name字段(可选) 在多个返回结果中增加精准度

1: 接口提交URL 提交方式

URL: https://gsdapi.com/api/v1.1/CZBankCardNo?key=******&cardno=******&name=企业名称
提交方式: GET

2: 传递参数:cardno、key

cardno: 需要查询的账号
name: 企业名称(可选)
key: 系统分配用户的APIkey值

3:返回数据字段说明

RESULT: 返回码 1查询有结果 0查询无结果 -1异常错误
MESSAGE: 返回码说明
Cardno:查询的账号
Datacount:返回数据记录数(返回结果并非唯一,有可能多条数据记录)
Data:返回的具体数据集
Bankname: 银行名称
Bankabc: 银行名称缩写
Province: 省份
City: 城市

4:示例

URL: https://gsdapi.com/api/v1.1/CZBankCardNo?key=5021eb********3c798a63fb&cardno=0000420*****0008110&name=xxx有限公司
GET参数
cardno: 117000***09400 账号
name: xxx有限公司(可以为空)
key: 5021eb********3c798a63fb 32位key值

5:返回json

{"RESULT":"1","MESSAGE":"查询有结果","Cardno":"0000420*****0008110","Datacount":"1","Data":[{"Bankname":"铜仁丰源村镇银行","Bankabc":"CZGZTRFY","Province":"贵州省","City":"铜仁"}]}

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/CZBankCardNo
提交方式: POST

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

uid: 系统分配的用户ID
time: 当前提交接口查询的时间(年月日时分秒)
sign: sign加密字符串(详见sign加密方法)
cardno: 需要查询的账号
name: 企业名称(可选)

3:返回数据字段说明

RESULT: 返回码 1查询有结果 0查询无结果 -1异常错误
MESSAGE: 返回码说明
Cardno:查询的账号
Datacount:返回数据记录数(返回结果并非唯一,有可能多条数据记录)
Data:返回的具体数据集
Bankname: 银行名称
Bankabc: 银行名称缩写
Province: 省份
City: 城市

4:示例

URL: https://gsdapi.com/api/v2/CZBankCardNo
POST参数
uid=1000012345
time=20211208101858(注:2021-12-08 10:18:58 当前查询时间去掉时间当中的- :)
sign=67bec755ce5704222a4ece083493dd3d54686281f4a80b83e1de277b860f34a3
cardno=0000420*****0008110 需要查询的账号
name=XXXX有限公司(可以为空)
以上参数POST form-data是数组

5:返回json

{"RESULT":"1","MESSAGE":"查询有结果","Cardno":"0000420*****0008110","Datacount":"1","Data":[{"Bankname":"铜仁丰源村镇银行","Bankabc":"CZGZTRFY","Province":"贵州省","City":"铜仁"}]}

V1.1版本 php curl 示例代码

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

V2版本 php curl 示例代码

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