银行卡类型及归属地查询
通过传入银行卡号返回银行名称、卡类型及卡归属地等信息。
  • 产品介绍
  • API文档
  • 合作咨询
申请接口

功能介绍 / Introduction

银行卡卡号归属地查询API
支持主流银行卡查询
  • 通过传入银行卡号返回银行名称、卡类型及卡归属地等信息。
  • 注册并申请，即送10次免费调用

适用于互联网等企业，根据银行卡号归属发卡区域。

业务场景 / Scenes

  • 用户分析

    根据用户注册时银行卡卡号，查询用户所属区域，以便于对用户分布进行分析。

  • 精准通知

    根据用户银行卡卡号归属区域不同，制定不同的活动推广、通知等。

  • 其他场景

    其他需要对银行卡卡号进行归属查询识别的场景。

快速调用API / FastCall

  • 1. 银行卡类型及归属地查询
  • 2. 接口状态码释义
接口描述： 通过传入银行卡号返回银行名称、卡类型及卡归属地等信息。
请求URL： https://api.jiadeapi.com/bankcardcore/query
请求方式： http get/post
请求Header：
名称 值
  Content-Type application/x-www-form-urlencoded
请求参数：
名称 必填 类型 说明
  key 是 String 接口请求key
  bankcard 是 String 查询的银行卡卡号，如：6217856101018144878
返回参数：
名称 类型 说明
  error_code Int 返回码，0表示成功
  reason String 描述
  result Object 结果
  bankname String 银行名称
  abbreviation String 银行英文简写
  cardtype String 卡类型（借记卡/贷记卡/准贷记卡）
  nature String 卡名称
  province String 归属地（省）
  city String 归属地（市区）
  card_bin int 银行卡bin码
  bin_digits int 银行卡bin长度
  isLuhn boolean 是否支持luhn校验
  kefu String 银行客服电话
  banklogo String 所属银行logo
  weburl String 银行官方网站
返回示例参考： 
                      
{
  "error_code": 0,
  "reason": "success",
  "result": {
    "bankcard": "6217856101018144878",
    "bankname": "中国银行",
    "abbreviation": "BOC",
    "cardtype": "借记卡",
    "nature": "借记IC个人普卡",
    "province": "江苏",
    "city": "苏州",
    "card_bin": "621785",
    "bin_digits": 6,
    "card_digits": 19,
    "isLuhn": true,
    "banklogo": "http://bkaear.market.alicloudapi.com/banklogo/zhongguoyinhang.gif",
    "weburl": "http://www.bank-of-china.com/",
    "kefu": "95566"
  }
}
状态码参考(error_code)：
  状态码 说明
  0 请求成功
  230501 银行卡格式不正确
  230502 请求数据源超时/异常，请重试
  230503 银行卡卡号错误
  230504 其他异常
  — —
  10001 接口请求Key校验不通过
  10008 请求的IP不在白名单
  10009 接口请求Key状态异常
  10012 请求超过次数限制
  10014 系统内部异常
  10020 接口维护
  10021 接口停用
  10023 请求频次过快，请稍后再试
 
  内容 详细
  联系电话: 159-5004-9812
  联系QQ: 3834700261
  技术支持: info@jiadeapi.com