主题
银行卡基础信息查询
接口描述
通过银行卡号查询银行卡基础信息,包括银行名称和银行卡类型。
接入前准备:
请求说明
HTTP 方法:
POST请求 URL:
/ai-cloud-cweis/netCheck/bankCardQueryHeader如下:
| 参数名称 | 值 |
|---|---|
| Content-Type | application/json;charset=UTF-8 |
请求参数:
| 参数名称 | 必填 | 数据类型 | 长度 | 参数描述 |
|---|---|---|---|---|
| bankCardNo | 是 | String | 21 | 银行卡号 |
| busFlowId | 否 | String | 64 | 业务流水号 |
请求示例:
json
{
"bankCardNo": "6222021234567890123",
"busFlowId": "1234567890"
}返回说明
返回参数:
| 返回值名称 | 数据类型 | 长度 | 描述 |
|---|---|---|---|
| code | String | 8 | 返回码,00000000表示成功 |
| message | String | 64 | 返回信息 |
| data | Object | - | 返回数据 |
| -flowId | Long | - | 交易流水ID |
| -bankCardNo | String | - | 银行卡号 |
| -bankName | String | - | 银行名称 |
| -bankCardType | String | - | 银行卡类型 |
返回示例:
json
{
"code": "00000000",
"message": "success",
"data": {
"flowId": 975431371847688192,
"bankCardNo": "6222021234567890123",
"bankName": "中国工商银行",
"bankCardType": "借记卡"
}
}错误码
以下仅列出了接口业务逻辑相关的错误码,其他错误码详见 公共CODE码表
| 码值 | 是否成功 | 是否计费 | 描述 |
|---|---|---|---|
| 00000000 | 是 | 是 | 查询成功 |
| 00000300 | 否 | 否 | 请求参数错误 |
| 00000302 | 否 | 否 | 渠道调用异常 |
| 00000540 | 否 | 否 | 银行卡基础信息查询异常 |
| 00000541 | 否 | 否 | 银行卡账号错误 |
| 00000542 | 否 | 否 | 银行卡账号查询无记录 |