查询境内银行支行基础信息
需要验证签名
接口描述
用于根据PingPong银行编码、支行信息,省份、城市信息分页查询支行基础信息
请求头
| Parameter | Type | Required | Description |
|---|---|---|---|
| Authorization | string | M | access_token |
| Content-Type | string | M | application/json |
请求参数
| Parameter | Type | Required | Description |
|---|---|---|---|
| bank_code | string(64) | M | PingPong银行编码 |
| branch_code | string(64) | O | 支行编码,模糊匹配 |
| branch_name | string(64) | O | 支行名称,模糊匹配 |
| province | string(32) | O | 省份名称,模糊匹配 |
| city | string(64) | O | 城市名称,模糊匹配 |
| page_no | long | O | 页码,默认1 |
| page_size | long | O | 每页数量,默认100,最大支持100 |
返回响应
| Parameter | Type | Required | Description |
|---|---|---|---|
| total | long | M | 总数 |
| current | long | M | 当前页 |
| size | string(64) | M | 每页显示条数,默认100 |
| records | array | M | 查询数据返回列表 |
records
| Parameter | Type | Required | Description |
|---|---|---|---|
| bank_code | string(64) | M | 银行编码 |
| bank_name | string(128) | M | 银行名称 |
| branch_code | string(64) | M | 国内支行代码/联行号 |
| branch_name | string(128) | M | 银行支行名称 |
| province | string(32) | M | 省份 |
| city | string(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"
}
}
{
"code": 900002,
"data": null,
"message": "参数不合法"
}
错误码
| 返回码 | 描述 | 建议 |
|---|---|---|
| 900000 | system error | 系统错误,请联系PingPong人员核查 |
| 900002 | illegal param | 参数错误,请根据提示更正信息 |