快速入门

API接口说明

其他

银行卡查询API说明

功能说明:

根据银行卡号,查询对应的发卡银行、卡种、卡片名称等信息。

点数抵扣:

每次成功的调用,扣减0.5点。

接口说明:

请求地址:https://toolbox.cpolar.cn/api/qrybankcard

请求方式:HTTP POST

字符集:UTF-8

Content-Type:application/json

请求参数:

参数 类型 长度 是否必填 说明
app_id string 16 请求方标识,在“我的API参数”菜单下获取。
version string 8 接口版本号,固定填写20240801。
trx_id string 1-16 交易ID,可由字母和数字组成。app_id+trx_id唯一确定一笔交易,不可重复。
card_no string 14-19 卡号,14-19位数字组成。
如果填写了card_no,则查询卡号对应的发卡银行、卡种、卡片名称等信息。
如果不填写card_no,则查询返回app_id+trx_id对应的原交易结果,此查询功能可在原交易没有收到实时响应时使用(原交易发起24小时内有效)。
signature string 44 签名值,用于验证报文的合法性,具体算法请参考签名算法说明

返回参数:

参数 类型 长度 是否必填 说明
resp_code string 4 响应码
resp_msg string 1-128 响应信息
app_id string 16 请求方标识,与请求中上送的值相同。
version string 8 版本号,与请求中上送的值相同。
trx_id string 1-16 交易ID,与请求中上送的值相同。
card_no string 14-19 卡号,与请求中上送的值相同。
bank_name string 1-128 发卡银行名称,查到匹配结果时返回。
card_type string 1 银行卡种,查到匹配结果时返回。
1 : 借记卡
2: 贷记卡
3: 准贷记卡
4: 预付费卡
9: 其他
card_name string 1-128 卡片名称,查到匹配结果时返回。
signature string 44 签名值,用于验证报文的合法性,交易请求处理成功后返回时填写。具体算法请参考签名算法说明

响应码说明:

响应码(resp_code) 响应信息(resp_msg) 说明及建议 是否计费
S001 请求处理成功
S002 请求处理成功,但未找到匹配信息
F001 请求内容为空 根据接口规范调整请求报文
F002 请求参数格式错误 根据接口规范调整请求报文
F003 请求方无效 检查APP ID填写是否正确
F004 请求报文验签失败 检查签名算法
F005 服务开通状态异常 检查是否开通了对应的接口服务
F006 账号可用点数不足 购买点数包
F007 重复请求 app_id+trx_id重复了,确保trx_id的唯一性
F008 请求过于频繁 请求超过QPS限制,降低调用频率或购买QPS套餐提高并发量
F998 没有查到对应的交易记录 原交易不存在,或已超过24小时的查询时效限制
F999 系统处理异常 联系我们,或稍后再试

请求报文示例:

{
    "app_id":"2024101165732077",
    "version":"20240801",
    "trx_id":"2024092827026736",
    "card_no":"6225237625260000",
    "signature":"fsty60KT6ce/cWDNFG+5fq0ybKU3JilTneIDVHXXV5U="
}										

响应报文示例:

{
    "resp_code":"S001",
    "resp_msg":"请求处理成功",
    "app_id":"2024101165732077",
    "version":"20240801",
    "trx_id":"2024092827026736",
    "card_no":"6225237625260000",
    "bank_name":"浦东发展银行",
    "card_type":"1",
    "card_name":"东方卡(银联卡)",
    "signature":"5Kcqj/yGsrWsBtAvxJUACdyqutSyKCrGxy3gIB7f83E="
}