通过输入银行卡号,能够快速查询该卡所属银行、卡类型以及开户行的具体信息,为企业提供了一个便捷、高效的安全工具。
该接口包含两个子接口
银行卡类型及归属地查询和联行号开户行查询搭配使用可查询开户支行信息。
以银行卡类型及归属地查询接口为例:
1. 请求参数说明
表格
| 参数名 | 必填 | 类型 | 说明 |
|---|---|---|---|
| key | 是 | string | 个人中心查看的API密钥 |
| bankcard | 是 | string | 需要查询的银行卡号 |
2. 返回参数说明
| 参数名 | 类型 | 说明 |
|---|---|---|
| bankcard | string | 银行卡号 |
| brand_name | string | 银行卡产品名称 |
| province | string | 省份 |
| city | string | 市 |
| type | string | 银行卡类型(如借记卡、信用卡) |
| bank_name | string | 银行名称 |
| simple_code | string | 银行简码 |
| tel | string | 客服电话 |
| img | string | 银行图片URL |
| url | string | 银行官网URL |
| is_luhn | int | 是否能通过Luhn效验(1是,0否) |
3. JSON返回示例
{
"code": 1,
"msg": "操作成功",
"data": {
"bankcard": "62220212345678901234",
"brand_name": "银联IC金卡",
"province": "北京市",
"city": "朝阳区",
"type": "借记卡",
"bank_name": "中国工商银行",
"simple_code": "ICBC",
"tel": "95588",
"img": "<url id="d008o0jfj2j93hdomagg" type="url" status="failed" title="" wc="0">http://static.tanshuapi.com/bank/383c8380573da87780df7c210f123d59.jpg</url>",
"url": "www.icbc.com.cn",
"is_luhn": 1,
"len": 16
}
}
4. Python代码示例
接口地址为:
`https://api.tanshuapi.com/api/attribution_bank/v2/index`
import requests
# 设置 API Key 和银行卡号
API_KEY = "your_api_key_here"
BANK_CARD = "62220212345678901234"
# 构建请求参数
params = {
"key": API_KEY,
"bankcard": BANK_CARD
}
# 发送请求
response = requests.get("https://api.tanshuapi.com/api/attribution_bank/v2/index", params=params)
# 解析返回结果
try:
result = response.json()
if result["code"] == 1:
print("查询成功!")
print(f"银行卡号: {result['data']['bankcard']}")
print(f"银行名称: {result['data']['bank_name']}")
print(f"省份: {result['data']['province']}")
print(f"城市: {result['data']['city']}")
print(f"银行卡类型: {result['data']['type']}")
print(f"是否通过Luhn效验: {'是' if result['data']['is_luhn'] == 1 else '否'}")
else:
print(f"查询失败,错误信息: {result['msg']}")
except Exception as e:
print(f"请求失败,错误信息: {str(e)}")
总结
通过广泛支持多种银行卡和实时更新数据,API确保能够确保用户在金融交易中能够快速验证银行卡信息,优化用户体验,并为市场分析和风险控制提供有力支持。