查询境内银行基础信息

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

接口描述

用于分页查询银行基础信息,支持根据银行编码查询或银行名称模糊查询

提示

1. 一般对私绑卡或付款仅需要查询银行基础信息即可

请求头

Parameter	Type	Required	Description
Authorization	string	M	access_token
Content-Type	string	M	application/json

请求参数

Parameter	Type	Required	Description
bank_name	string(128)	O	银行名称,模糊查询
page_no	long	O	页码,默认1
page_size	long	O	每页数量，默认100，最大100

返回响应

Parameter	Type	Required	Description
total	long	M	总数
current	long	M	当前页
size	long	M	每页显示条数
records	array	M	查询数据返回列表

records

Parameter	Type	Required	Description
bank_code	string(64)	M	银行编码
bank_name	string(128)	M	银行名称

返回示例

成功

{
    "code": 200,
    "data": {
        "current": 1,
        "size": 50,
        "total": 1,
        "records": [
            {
                "bank_code": "01000000",
                "bank_name": "中国邮政储蓄银行",
                "bank_name_cn_short": "邮储银行"
            }
        ]
    },
    "message": "SUCCESS"
}

失败

{
    "code": 900002,
    "data": null,
    "message": "参数不合法"
}

错误码

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