当前位置: 产品API > 数据 > 银行卡信息查询
产品介绍
  • 服务对象
    任何人
  • 产品详情

    支持近70亿张银联卡信息查询。输入银行卡卡号,输出返回发卡行、发卡行机构代码、卡性质、卡类别、卡种、卡品牌、卡产品、卡等级、卡介质、所属总行机构中文名称、所属总行机构中文简称。


    资费详情: 

    本产品推广期为2017年10月1日至2019年12月31日,推广期内本产品可免费使用。推广期过后的收费标准将提前30个工作日在本平台另行公示。

  • 应用场景

    银行卡信息查询可广泛应用于各行业,信用评估、欺诈风险、精准营销、潜客挖掘等场景。

应答码参照
应答码列表
  • 应答码 描述 解决方案
    0000 处理成功。
    0001 服务未定义。
    1000 错误的银行卡号。
    2000 未找到对应的银联卡信息。
    8000 未知错误。
    9901 您的IP(XXX.XXX.XXX.XXX)没有登记,请登录银联开放平台(open.unionpay.com)进行白名单登记。
    9902 您的IP(XXX.XXX.XXX.XXX)已被限制访问,请登录银联开放平台(open.unionpay.com)提交申诉请求。
    9903 您的IP(XXX.XXX.XXX.XXX)请求过于频繁,已被临时限制,请5分钟后再尝试。
    9904 您的 IP(XXX.XXX.XXX.XXX)不属于你设置的开发IP列表,请登录银联开放平台(open.unionpay.com)确认相关配置。
    9905 请求参数值有误,请确认请求参数信息。
    9906 您的账号不具备当前产品请求权限,如有权限,可重新获取该产品Token后再尝试。
    9907 app_id与app_secret验证失败。
    9908 您的Token已过期,请重新获取Token。
    9909 您的Token信息非最新Token,请确保您的系统中使用的是最新的Token值。
    9910 您的签名密钥未设置,请登录银联开放平台(open.unionpay.com)确认相关配置。
    9911 您的签名信息验证不通过,请检查您的签名实现是否符合银联开放平台(open.unionpay.com)提供的签名规则。
    9912 您的报文格式有误,要求报文符合JSON数据格式。
    9913 你的报文数据有误,未通过数据信息校验,具体原因视业务需求。
    9914 您的报文无法解密,请检查您在银联开放平台(open.unionpay.com)上提供的RSA公钥是否正确。
    9915 您的API调用额度已耗尽,需充值付费后补充调用额度。
    9916 您的API并发调用额度已耗尽,需联系管理员调整您的并发限额。
    9917 您的账号不具备当前产品API请求权限,请联系相关业务接口人。
    9991 银联开放平台系统内部错误:产品服务调用失败。
    9992 银联开放平台系统内部错误:产品服务系统未知错误。
    9993 银联开放平台系统内部错误:产品服务未注册至服务中心。
    9994 银联开放平台系统内部错误:产品服务参数错误。
接入流程
  1. 如需申请该API,请点击右上角“业务申请”,并认真填写相关内容;

  2. 待业务接口人审核通过后即可调用该API,审核周期约为2-3个工作日;

  3. 技术联调,可参照《“快速接入”产品API技术文档—接入指南》

报文举例

1.报文举例-获取token:


请求URL:


https://openapi.unionpay.com/upapi/cardbin/token?app_id=[value]&app_secret=[value]



 

应答JSON报文体

{
    “token”: “”,
    “expire_in”:7200
}



2.报文举例-银行卡信息查询



请求URL:


https://open.unionpay.com/upapi/cardbin/cardinfo?token=[value]&sign=[value]&ts=[ts]



请求报文参数:


{
    “cardNo”: “”
}


应答JSON报文体:


{
“respCd”: “0000”,
“respMsg”: “”, 
“data”: {
   “issNm”: “”,
   “issInsId”: “”,
   “issAbbr”: “”,
   “cardAttr”: “”,
   “cardCata”: “”,
   “cardClass”: “”,
   “cardBrand”: “”,
   “cardProd”: “”,
   “cardLvl”: “”,
   “cardMedia”: “”,
   “hdqrsInsCnNm”: “”,
   “hdqrsInsCnAbbr ”: “”
}}



技术指南

1. “快速接入”产品API使用教程请参考在线文档:

“快速接入”产品API指南—接入指南


2. “快速接入”产品API安全调用过程请参考在线文档:

2.1“快速接入”产品API指南—获取产品token

2.2快速接入”产品API指南—产品功能接口调用


3. “快速接入”产品API接口调用报文签名样例请参考在线文档:

“快速接入”产品API指南—报文签名样例代码


4. “快速接入”产品API测试工具使用说明请参考在线文档:

“快速接入”产品API指南—“快速接入”测试工具

常见问题
  • 如何使用沙箱测试?
  • 调用接口返回提示 {"respMsg":"body or sign is null.","respCd":"9905"}

    API接口需使用body部分传送JSON数据,故而HTTP请求的content-type需使用application/json,而不是application/x-www-form-urlencoded。

  • 卡Bin查询的查询tps上限是多少?

    目前,银联开放平台统一限制来自同一IP的调用tps上限为每秒20个请求、用户的默认调用限制为每天1000次。

文档下载
API接口
获取token
接口描述
产品token是开放平台每个产品的全局唯一接口调用凭据,用户调用各接口时都需使用产品token。
请求方式
GET
生产地址
https://openapi.unionpay.com/upapi/cardbin/token
测试地址
https://openapi.unionpay.com/upapi/cardbintest/token
请求URL参数
名称 标识 字段类型 长度 请求要求 默认值 备注
用户唯一凭证 app_id string M-必填 详情可在登录开放平台后“个人中心-我的信息-API认证信息-API认证账号”中查看。
用户唯一凭证密钥 app_secret string M-必填 详情可在登录开放平台后“个人中心-我的信息-API认证信息-API认证密钥”中查看。
同步应答参数
名称 标识 字段类型 长度 请求要求 默认值 备注
产品token token string M-必填 获取到的凭证;凭证是字符串。
过期时间 expire_in string M-必填 凭证有效时间,单位:秒。
银行卡信息查询
接口描述
根据银行卡卡号,返回发卡行、发卡行机构代码、卡性质、卡类别、卡种、卡品牌、卡产品、卡等级、卡介质、所属总行机构中文名称、所属总行机构中文简称。
请求方式
POST
生产地址
https://openapi.unionpay.com/upapi/cardbin/cardinfo
测试地址
https://openapi.unionpay.com/upapi/cardbintest/cardinfo
请求URL参数
名称 标识 字段类型 长度 请求要求 默认值 备注
产品token token string M-必填 详情请参考“获取token”接口中应答参数“token”的具体数据。
签名信息 sign string M-必填 详细签名算法可参考“接入指南”板块第3条。
时间戳 ts long M-必填 单位:毫秒,对于Java一般使用System.currentTimeMillis();获取。
请求报文体参数
名称 标识 字段类型 长度 请求要求 默认值 备注
银行卡卡号 cardNo string M-必填 为16-23位数字。
同步应答参数
名称 标识 字段类型 长度 请求要求 默认值 备注
应答码 respCd string M-必填
应答消息 respMsg string M-必填 返回消息详情。
应答报文 data map M-必填
发卡行中文名称 issNm string M-必填 变长60位字符串。
发卡行机构代码 issInsId string M-必填 变长11位字符串
发卡行中文简称 issAbbr string M-必填 变长40位字符串
卡性质 cardAttr string M-必填 **-所有卡性质; 00-未知; 01-借记卡; 02-贷记卡; 03-准贷记卡; 04-借贷合一卡; 05-预付费卡; 06-半开放式预付费卡; 99-单用途预付费卡。
卡类别 cardCata string M-必填 0-未知 ; 1-银行卡; 2-行业卡。
卡种 cardClass string M-必填 01-人民币卡(境内发的人民币银联卡); 02-人民币境外卡(境外发的人民币银联标准卡); 03-多币种卡(境内和境外发的多币种银联标准卡); 04-国际卡(境内发的外币银联标准卡); 05-境外卡(境外发的外币银联标准卡); 06-外资卡(外资银行在境内发的银联标准卡); 07-外卡(5大国际组织); 99-其他。
卡品牌 cardBrand string M-必填 11-9字头银联卡; 12-62银联标准卡; 13-其他银联标准卡(视同); 01-VISA卡(VIS)银联标识卡; 02-万事达卡(MCC)银联标识卡; 03-万事顺卡(MAE)银联标识卡; 04-JCB卡(JCB)银联标识卡; 05-大莱卡(DinnerClub)银联标识卡; 06-运通卡(AMX)银联标识卡; 07-其他银联标识卡; 99-其他。
卡产品 cardProd string M-必填 00-未知; 01-公务卡; 02-公共缴费类卡; 03-航空卡; 04-学生卡; 05-社保卡; 06-交通卡; 07-积分卡; 08-军人卡; 09-市民卡; 10-商务卡; 11-旅游卡。
卡等级 cardLvl string M-必填 0-未知; 1-普卡; 2-银卡; 3-金卡; 4-白金卡; 5-钻石卡; 6-无限卡。
卡介质 cardMedia string M-必填 1-磁条; 2-IC卡; 3-Fall Back卡; 4-虚拟卡; 5-纯字符卡; 6-生物特征卡; 7-无卡。
所属总行机构中文名称 hdqrsInsCnNm string M-必填 变长60位字符串
所属总行机构中文简称 hdqrsInsCnAbbr string M-必填 变长40位字符串
联系我们

业务咨询: 赵希

021-20633170

zhaoxi@unionpay.com

技术咨询: 赵希

021-20633170

zhaoxi@unionpay.com

中国银联版权所有©2002-2019沪 ICP备07032180号