跳到主要内容

查询境内银行支行基础信息

POST /v1/mid-open-api/base/bank/cn-branch-bank/query
需要验证签名

接口描述

用于根据PingPong银行编码、支行信息,省份、城市信息分页查询支行基础信息

请求头

ParameterTypeRequiredDescription
AuthorizationstringMaccess_token
Content-TypestringMapplication/json

请求参数

ParameterTypeRequiredDescription
bank_codestring(64)MPingPong银行编码
branch_codestring(64)O支行编码,模糊匹配
branch_namestring(64)O支行名称,模糊匹配
provincestring(32)O省份名称,模糊匹配
citystring(64)O城市名称,模糊匹配
page_nolongO页码,默认1
page_sizelongO每页数量,默认100,最大支持100

返回响应

ParameterTypeRequiredDescription
totallongM总数
currentlongM当前页
sizestring(64)M每页显示条数,默认100
recordsarrayM查询数据返回列表

records

ParameterTypeRequiredDescription
bank_codestring(64)M银行编码
bank_namestring(128)M银行名称
branch_codestring(64)M国内支行代码/联行号
branch_namestring(128)M银行支行名称
provincestring(32)M省份
citystring(64)M城市

返回示例

    {
"code": 200,
"data": {
"bank_code": "01020000",
"bank_name": "中国工商银行",
"bank_name_cn_short": "工商银行",
"bank_name_en_short": "ICBC",
"branch_code": "102110081214",
"branch_name": "中国工商银行股份有限公司天津建设路支行",
"city": "天津",
"city_code": "120000",
"province": "天津",
"province_code": "120000"
},
"message": "SUCCESS"
}
}

错误码

返回码描述建议
900000system error系统错误,请联系PingPong人员核查
900002illegal param参数错误,请根据提示更正信息