/data/verify_bankcard
1.接口描述
该API的功能是对银行卡类型及归属地的查询。
请求方式：
POST
请求URL：
https://cloudapi.deepfinch.com/data/verify_bankcard
调试工具
2.请求参数
2.1 请求头域
| 字段 | 类型 | 必需 | 描述 |
|---|---|---|---|
| X-DF-API-ID | string | 是 | API调用凭证信息，详细信息请参考API调用 |
| X-DF-API-SECRET | string | 是 | API调用凭证信息，详细信息请参考API调用 |
2.2 请求体
| 字段 | 类型 | 必需 | 描述 |
|---|---|---|---|
| card_number | string | 是 | 银行卡号 |
| ext | int | 否 | 是否返回扩展信息ext字段 1:是 0:否 |
3.返回参数
正常响应 （200）
| 字段 | 类型 | 描述 |
|---|---|---|
| request_id | string | 本次请求的 id |
| status | string | 状态。正常为 OK ，其他值表示失败。详见错误码 |
| result_code | int | 0: 查询成功 1: 查询失败 2: 查询异常 |
| result_message | string | 查询结果描述 |
| result | string | 查询结果 |
其中result的字段如下：
| 字段 | 类型 | 描述 |
|---|---|---|
| bank | string | 所属银行 |
| cardtype | string | 银行卡类型 |
| nature | string | 银行卡种类 |
| kefu | string | 客服电话 |
| bankcard | string | 银行卡号 |
| logo | string | 银行logo链接 |
| info | string | 银行卡归属信息 |
| ext | object | 扩展信息，当参数ext指定为1时返回此字段 |
其中ext的字段如下：
| 字段 | 类型 | 描述 |
|---|---|---|
| card_bin | string | 银行卡bin码 |
| bin_len | int | 银行卡bin码长度 |
| card_len | int | 银行卡号长度 |
| luhn | boolean | 是否符合luhn校验 |
result_code和result_message的字段：
| result_code | result_message |
|---|---|
| 0 | 查询成功 |
| 1 | 查询失败 |
| 2 | 接口异常 |
输出示例：
{
"request_id":"TID6db8872a5a2d4f6abf7d8513b66708af"，
"status":"OK",
"result_code":0,
"result_message":"查询成功",
"result":{
"bank":"中国交通银行",
"cardtype":"借记卡",
"nature":"交银IC卡",
"kefu":"95559",
"bankcard":"6222620140001380854",
"logo":"http://pic.dataox.com.cn/jiaotong.png",
"info":"江苏省-苏州市",
"ext":{
"card_bin":"622262",
"bin_len":6,
"card_len":19,
"luhn":true
}
}
}
4.错误码
| 状态码 | status 字段 |
说明 |
|---|---|---|
400 |
INVALID_ARGUMENT | 请求参数错误 |
400 |
QUERY_FAILED | 核验失败 |
401 |
UNAUTHORIZED | 未授权或授权失败 |
403 |
RATE_LIMIT_EXCEEDED | 调用频率超出限额 |
404 |
NOT_FOUND | 请求路径错误 |
500 |
INTERNAL_ERROR | 服务器内部错误 |
输出示例：
{
"status": "DETECTION_FAILED",
"request_id": "TID8bf47ab6eda64476973cc5f5b6ebf57e"
}