银行卡信息查询

数据 收单机构 商户 开发者 发卡机构 快速接入
根据银行卡卡号,返回发卡行、发卡行机构代码、卡性质、卡类别、卡种、卡品牌、卡产品、卡等级、卡介质、所属总行机构中文名称、所属总行机构中文简称。

接入服务商:银联开放平台

API ID:51

接口状态:正常

业务申请
沙箱测试
沙箱调用

接口名称

获取token

接口描述

产品token是开放平台每个产品的全局唯一接口调用凭据,用户调用各接口时都需使用产品token。

接口地址

测试地址: https://openapi.unionpay.com/upapi/cardbintest/token


生产地址: https://openapi.unionpay.com/upapi/cardbin/token

请求方式

HTTP GET

请求url参数

名称 标识 字段类型 长度 请求要求 默认值 备注
用户唯一凭证 app_id string M-必填 详情可在登录开放平台后“个人中心-我的信息-API认证信息-API认证账号”中查看。
用户唯一凭证密钥 app_secret string M-必填 详情可在登录开放平台后“个人中心-我的信息-API认证信息-API认证密钥”中查看。

应答参数

名称 标识 字段类型 长度 请求要求 默认值 备注
产品token token string M-必填 获取到的凭证;凭证是字符串。
过期时间 expire_in string M-必填 凭证有效时间,单位:秒。

接口名称

银行卡信息查询

接口描述

根据银行卡卡号,返回发卡行、发卡行机构代码、卡性质、卡类别、卡种、卡品牌、卡产品、卡等级、卡介质、所属总行机构中文名称、所属总行机构中文简称。

接口地址

测试地址: https://openapi.unionpay.com/upapi/cardbintest/cardinfo


生产地址: https://openapi.unionpay.com/upapi/cardbin/cardinfo

请求方式

HTTP POST

请求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位字符串
产品详情

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


资费详情: 

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

应用场景

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

应用对象

任何人

接入流程
  1. 如需申请该API,请点击右上角“业务申请”,并认真填写相关内容;

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

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

应答码参照:
应答码 描述
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.报文举例-获取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”: {
                  “cardBin”: “”,
                  “issNm”: “”,
                  “cardAttr”: “”,
                  “cardCata”: “”,
                  “cardClass”: “”,
                  “cardBrand”: “”,
                  “cardProd”: “”,
                  “cardLvl”: “”,
                  “cardMedia”: “”
            }
}



请求方法


Magpie2 报文举例(能力开放引擎调用商户平台)


请求报文参数:


{

    “api”: “cardinfo”,
    “data”:原封不动转发用户请求内容
}


应答JSON报文体:


{
  
    “respCd”: “0000”,
    “respMsg”: “”, 
    “data”: {
                   “cardBin”: “”,
                   “issNm”: “”,
                   “cardAttr”: “”,
                   “cardCata”: “”,
                   “cardClass”: “”,
                   “cardBrand”: “”,
                   “cardProd”: “”,
                   “cardLvl”: “”,
                   “cardMedia”: “”
              }
}

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

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


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

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

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


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

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


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

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

常见问题
2. 调用接口返回提示 {"respMsg":"body or sign is null.","respCd":"9905"}
解答详情:

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

3. 卡Bin查询的查询tps上限是多少?
解答详情:

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

相关文档

upapi-clientV1.0.0.jar 更新时间:2017-09-01 17:21:48

卡BIN信息查询测试工具源码V1.0.0.zip 更新时间:2017-09-01 17:28:15

卡BIN信息查询产品接口规范V1.0.0.docx 更新时间:2018-07-05 17:05:07

咨询我们
业务咨询
姓名: 赵希
电话: 021-20633170
邮箱: zhaoxi@unionpay.com
技术咨询
姓名: 赵希
电话: 021-20633170
邮箱: zhaoxi@unionpay.com
热门推荐