查询正向打款银行信息
接口描述
- 用于获取收款银行的银行联行号等信息，确保能正常打款，根据开户行名称查询，并返回最多20条与之匹配的的开户行/支行信息，用于获取收款银行，联行号信息
- 注：该接口为非必选接口，联行号信息可通过其他数据源查询确认
接口地址
/v2/identity/auth/pub/organization/{flowId}/subbranch
请求方式
- GET
- 请求报文体采用Json数据格式，编码方式采用UTF-8编码
请求参数
| 参数名 | 说明 | 参数类型 | 是否必填 | 类型 |
|---|---|---|---|---|
| flowId | 认证流程Id | path | 是 | string |
| keyWord | 银行名称搜索关键字，建议输入完整的银行名称 | query | 是 | string |
请求示例
GET /v2/identity/auth/pub/organization/836551334533533698/subbranch?keyWord=平安银行杭州高新支行 HTTP/1.1
响应参数
| 参数名 | 说明 | 类型 |
|---|---|---|
| code | int | 接口响应结果码 |
| message | string | 接口响应结果描述 |
| data | object | 接口响应结果数据 |
| list | array | 匹配银行信息列表 |
| bank | string | 匹配银行总行名称 |
| bankName | string | 匹配支行完整名称 |
| cnapsCode | string | 联行号信息 |
| province | string | 支行所在省份 |
| city | string | 支行所在市/区 |
响应示例
{
"code": 0,
"message": "成功",
"data": {
"list": [{
"bankName": "平安银行杭州高新支行",
"bank": "平安银行",
"cnapsCode": "307331002584",
"city": "杭州市",
"province": "浙江"
}]
}
}
错误码
| 错误码 | 错误信息 | 错误原因 |
|---|---|---|
| 30500101 | 参数错误：实名账号Id不能为空 | 在uri中未包含accountId |