银行账户转账开户行联行号接口
银行账户转账开户行联行号接口数据支持国内中、农、工、建、交、邮储银行、134家商业银行、全国31省市农村信用社及农村商业银行、民营银行、1400+村镇银行,总计共3000+银行对公账户、存折账户所属行、开户行归属地省市、转账开户行、大额行号(联行号)查询。
文档概述
版本说明
- 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
银行账户转账开户行联行号接口说明
银行账户转账联行号接口共分为4个接口
1. 企业对公帐户转帐联行号
2. 村镇银行对公转帐联行号
3. 外资银行对公转帐联行号
4. 个人存折帐户转帐联行号
1. 企业对公帐户主接口包含了部分村镇银行和外资银行对公账归属地户查询
2. 村镇银行对公 包含了国内1400家以上的村镇银行对公账户归属地查询
3. 外资银行对公 包含了国内20+以上外资银行 对公账户归属地查询
4. 个人存折帐户 包含了国内100+银行个人帐户识别及归属地查询
以上接口接入方法参见对公账户、存折账户归属地接口,请求数据一样,返回数据增加了zzkhh,zzlhh字段
由于对公账户的非唯一性,查询结果也会非唯一,有可能会出现多个查询结果或查询结果与实际并不相符的情况!
转帐联行号接口返回的zzkhh,zzlhh表示分行名称及分行联行号 仅用于转账使用,不能代表该账户的具体开户支行,如需具体支行信息请联系咨询商务合作。
接口参数详情
https://gsdapi.com/api/v2/BankCardNoKHHLHH 对公账户转账联行号主接口
https://gsdapi.com/api/v2/CZBankCardNoLHH 村镇银行对公账户转账联行号接口
https://gsdapi.com/api/v2/WZBankCardNoLHH 外资银行对公账户转账联行号接口
https://gsdapi.com/api/v2/PassBookKHHLHH 存折账户转账联行号接口
POST
请求参数
| 参数名 | 类型 | 是否必选 | 说明 |
|---|---|---|---|
| uid | String | 是 | 系统分配的用户ID |
| time | String | 是 | 当前提交接口查询的时间(年月日时分秒) |
| sign | String | 是 | sign加密字符串(详见sign加密方法) |
| cardno | String | 是 | 需要查询的帐号 |
| name | String | 否 | 企业名称(可选) |
响应参数
| 参数名 | 类型 | 说明 |
|---|---|---|
| RESULT | Integer | 返回码 1查询有结果 0查询无结果 -1异常错误 |
| MESSAGE | String | 返回码说明 |
| Cardno | String | 查询的帐号 |
| Datacount | String | 返回数据记录数(返回结果并非唯一,有可能多条数据记录) |
| Data | Object | 返回的具体数据集 |
| Bankname | String | 银行名称 |
| Bankabc | String | 银行名称缩写 |
| Province | String | 省份 |
| City | String | 城市 |
| Zzkhh | String | 转账开户分行名称 |
| Zzlhh | String | 转账开户分行对应的联行号 |
请求示例
uid=1000012345 time=20211208101858(注:2021-12-08 10:18:58 当前查询时间去掉时间当中的- :) sign=67bec755ce5704222a4ece083493dd3d54686281f4a80b83e1de277b860f34a3 cardno=42250133110100888888 需要查询的帐号 name=XXXX有限公司(可以为空)
响应示例
{
"RESULT": "1",
"MESSAGE": "查询有结果",
"Cardno": "42250133110100888888",
"Datacount": "1",
"Data": [
{
"Bankname": "中国建设银行",
"Bankabc": "CCB",
"Province": "湖北省",
"City": "宜昌",
"Zzkhh": "中国建设银行股份有限公司三峡分行",
"Zzlhh": "105526000011"
}
]
}
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