根据银行卡号,查询对应的发卡银行、卡种、卡片名称等信息。
每次成功的调用,扣减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=" }