文详解银行卡归属地及开户行查询API

375 阅读2分钟

通过输入银行卡号,能够快速查询该卡所属银行、卡类型以及开户行的具体信息,为企业提供了一个便捷、高效的安全工具。

该接口包含两个子接口
银行卡类型及归属地查询联行号开户行查询搭配使用可查询开户支行信息。
以银行卡类型及归属地查询接口为例:

1. 请求参数说明

表格
参数名必填类型说明
keystring个人中心查看的API密钥
bankcardstring需要查询的银行卡号

2. 返回参数说明

参数名类型说明
bankcardstring银行卡号
brand_namestring银行卡产品名称
provincestring省份
citystring
typestring银行卡类型(如借记卡、信用卡)
bank_namestring银行名称
simple_codestring银行简码
telstring客服电话
imgstring银行图片URL
urlstring银行官网URL
is_luhnint是否能通过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确保能够确保用户在金融交易中能够快速验证银行卡信息,优化用户体验,并为市场分析和风险控制提供有力支持。