银行卡查询
正常 NEW银行卡号离线解析引擎。基于 Luhn 校验 (ISO/IEC 7812-1) + 6 位卡 BIN (发卡行识别码) 号段库, 返回卡组织、卡种 (借记/信用)、发卡行与客服热线。纯离线、无外部 API 依赖, 默认脱敏返回, 不落库卡号。
¥
0.002
/ 次
按次计费
健康检查 。
健康检查 。
调用方式：在接口地址后拼接
?key=您的API密钥 即可直接调用；也可改用 Authorization: Bearer 或 X-App-Key 请求头传递，避免密钥出现在访问日志中。
GET
http://www.shujuyu.cn/v1/api/bankcard/ping
JSON
请求参数
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| key | string | 是 | 您的API密钥，可在个人中心获取 |
返回参数说明
| 参数名 | 类型 | 说明 |
|---|---|---|
| code | int | - |
| msg | string | - |
| data | object | - |
| data.version | string | - |
| data.time | string | - |
请求示例
返回示例
{"msg":"pong","code":0,"data":{"time":"2026-11-01 12:00:00","version":"1.0"}}
BIN 库统计 。
BIN 库统计 。
调用方式：在接口地址后拼接
?key=您的API密钥 即可直接调用；也可改用 Authorization: Bearer 或 X-App-Key 请求头传递，避免密钥出现在访问日志中。
GET
http://www.shujuyu.cn/v1/api/bankcard/stats
JSON
请求参数
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| key | string | 是 | 您的API密钥，可在个人中心获取 |
返回参数说明
| 参数名 | 类型 | 说明 |
|---|---|---|
| code | int | - |
| msg | string | - |
| data | object | - |
| data.status | string | - |
| data.banks | int | - |
| data.bins | int | - |
| data.by_type | object | - |
| data.by_brand | object | - |
| data.by_bank | object | - |
请求示例
返回示例
{"msg":"success","code":0,"data":{"bins":277,"banks":16,"status":"ok","by_bank":{"icbc":{"name":"工商银行","count":26}},"by_type":{"debit":176,"credit":101},"by_brand":{"visa":36,"unionpay":216,"mastercard":16}}}
发卡行目录 。可选参数:
api-bankcard-banks
调用方式：在接口地址后拼接
?key=您的API密钥 即可直接调用；也可改用 Authorization: Bearer 或 X-App-Key 请求头传递，避免密钥出现在访问日志中。
GET
http://www.shujuyu.cn/v1/api/bankcard/banks
JSON
请求参数
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| key | string | 是 | 您的API密钥，可在个人中心获取 |
| category | string | 否 | 按类别过滤: 国有大型商业银行 / 股份制商业银行 / 城市商业银行 |
| keyword | string | 否 | 搜索 code / 全称 / 简称 / 英文缩写 (不区分大小写), 可与 category 组合 |
返回参数说明
| 参数名 | 类型 | 说明 |
|---|---|---|
| code | int | - |
| msg | string | - |
| data | object | - |
| data.total | int | - |
| data.list | array | - |
请求示例
返回示例
{"msg":"success","code":0,"data":{"list":[{"en":"ICBC","code":"icbc","name":"中国工商银行","hotline":"95588","category":"国有大型商业银行","bins_count":26,"short_name":"工商银行"}],"total":16}}
单卡查询。Body: {"card_no": "6222020200112345
单卡查询。Body: {"card_no": "6222020200112345", "raw": false, "expiry": "12/27"}
调用方式：在接口地址后拼接
?key=您的API密钥 即可直接调用；也可改用 Authorization: Bearer 或 X-App-Key 请求头传递，避免密钥出现在访问日志中。
POST
http://www.shujuyu.cn/v1/api/bankcard/query
JSON
请求参数
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| key | string | 是 | 您的API密钥，可在个人中心获取 |
| card_no | string | 是 | - |
| raw | bool | 是 | - |
| expiry | string | 是 | - |
返回参数说明
| 参数名 | 类型 | 说明 |
|---|---|---|
| code | int | - |
| msg | string | - |
| data | object | - |
| data.card_no | string | - |
| data.masked | string | - |
| data.pretty | string | - |
| data.length | int | - |
| data.luhn_valid | bool | - |
| data.length_valid | bool | - |
| data.expected_lengths | array | - |
| data.brand | string | - |
| data.brand_name | string | - |
| data.is_valid | bool | - |
| data.bin | string | - |
| data.bin_source | string | - |
| data.matched | bool | - |
| data.card_type | string | - |
| data.card_type_name | string | - |
| data.card_name | string | - |
| data.bank | object | - |
| data.expiry | object | - |
请求示例
返回示例
{"msg":"success","code":0,"data":{"bin":"622588","bank":{"en":"CMB","code":"cmb","name":"招商银行","hotline":"95555","category":"股份制商业银行","short_name":"招商银行"},"brand":"unionpay","expiry":{"year":2027,"error":"","input":"12/27","month":12,"state":"valid","valid":true},"length":16,"masked":"622588******9736","pretty":"6225 88** **** 9736","card_no":"622588******9736","matched":true,"is_valid":true,"card_name":"一卡通","card_type":"debit","bin_source":"exact","brand_name":"银联","luhn_valid":true,"length_valid":true,"card_type_name":"借记卡","expected_lengths":[16,17,18,19]}}
批量查询, 最多 10 条。Body: {"card_nos": ["62220
批量查询, 最多 10 条。Body: {"card_nos": ["6222020200112345", "4367421234567890"], "raw": false}
调用方式：在接口地址后拼接
?key=您的API密钥 即可直接调用；也可改用 Authorization: Bearer 或 X-App-Key 请求头传递，避免密钥出现在访问日志中。
POST
http://www.shujuyu.cn/v1/api/bankcard/query-batch
JSON
请求参数
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| key | string | 是 | 您的API密钥，可在个人中心获取 |
| card_nos | array | 是 | - |
| raw | bool | 是 | - |
返回参数说明
| 参数名 | 类型 | 说明 |
|---|---|---|
| code | int | - |
| msg | string | - |
| data | object | - |
| data.total | int | - |
| data.valid | int | - |
| data.invalid | int | - |
| data.matched | int | - |
| data.luhn_invalid | int | - |
| data.by_brand | object | - |
| data.max_limit | int | - |
| data.list | array | - |
请求示例
返回示例
{"msg":"success","code":0,"data":{"list":[{"bin":"622202","bank":{"en":"ICBC","code":"icbc","name":"中国工商银行","hotline":"95588","category":"国有大型商业银行","short_name":"工商银行"},"brand":"unionpay","index":0,"length":16,"masked":"622202******2345","pretty":"6222 02** **** 2345","card_no":"622202******2345","matched":true,"is_valid":false,"card_name":"牡丹灵通卡-e时代","card_type":"debit","bin_source":"exact","brand_name":"银联","luhn_valid":false,"length_valid":true,"card_type_name":"借记卡","expected_lengths":[16,17,18,19]},{"bin":"436742","bank":{"en":"CCB","code":"ccb","name":"中国建设银行","hotline":"95533","category":"国有大型商业银行","short_name":"建设银行"},"brand":"visa","index":1,"length":16,"masked":"436742******7890","pretty":"4367 42** **** 7890","card_no":"436742******7890","matched":true,"is_valid":false,"card_name":"龙卡贷记卡","card_type":"credit","bin_source":"exact","brand_name":"Visa","luhn_valid":false,"length_valid":true,"card_type_name":"信用卡","expected_lengths":[13,16,19]}],"total":2,"valid":0,"invalid":2,"matched":2,"by_brand":{"visa":1,"unionpay":1},"max_limit":10,"luhn_invalid":2}}
产品说明
产品概述
银行卡号离线解析引擎。基于 Luhn 校验 (ISO/IEC 7812-1) + 6 位卡 BIN (发卡行识别码) 号段库, 返回卡组织、卡种 (借记/信用)、发卡行与客服热线。纯离线、无外部 API 依赖, 默认脱敏返回, 不落库卡号。
使用场景
数据查询：快速集成 银行卡查询 到您的应用中
业务系统：将 银行卡查询 数据嵌入业务流程
开发工具：通过 API 接口获取 金融财税 数据
数据分析：基于 银行卡查询 数据进行分析和决策
费用计算
按次计费单价
¥0.002
/ 次
每次调用接口从账户余额中扣除相应费用，VIP 用户可享折扣
扣费优先级
免费额度
次数包
余额扣费
计费方式详解
1
免费额度
· 接口每日免费额度已关闭
· VIP 用户月度免费额度：
· 个人版：每月 5000 次，本接口月上限 5000 次
· 专业版：每月 30000 次，本接口月上限 30000 次
· 企业版：每月 200000 次，本接口月上限 200000 次
· 账户如有注册/活动赠送的免费次数，会优先于接口免费额度扣减
· VIP 月度免费额度仅适用于单次售价不高于 ¥0.0800/次 的接口；接口每日免费额度按接口配置执行
VIP 月度免费额度每月重置，未使用部分不累计至下月。
· VIP 用户月度免费额度：
· 个人版：每月 5000 次，本接口月上限 5000 次
· 专业版：每月 30000 次，本接口月上限 30000 次
· 企业版：每月 200000 次，本接口月上限 200000 次
· 账户如有注册/活动赠送的免费次数，会优先于接口免费额度扣减
· VIP 月度免费额度仅适用于单次售价不高于 ¥0.0800/次 的接口；接口每日免费额度按接口配置执行
VIP 月度免费额度每月重置，未使用部分不累计至下月。
2
次数包
预付费购买固定调用次数，折算单价与按次付费相同，用完为止。
次数包为独立计费，不与 VIP 折扣叠加。
请在有效期内使用，过期后未使用的次数不可再用。
次数包为独立计费，不与 VIP 折扣叠加。
请在有效期内使用，过期后未使用的次数不可再用。
3
余额扣费
按次从账户余额扣除费用；所有用户可享量折扣，VIP 用户额外享 VIP 折扣。
扣费公式：实际扣费 = 接口单价 × (1 - VIP 折扣比例 - 量折扣比例)，并受总折扣上限和最低利润率保护约束
VIP 折扣： 个人版9折 专业版8折 企业版7折
量折扣： 月付费调用 ≥1000 次享 2%、 月付费调用 ≥10000 次享 5%、 月付费调用 ≥20000 次享 10%
· 量折扣按账号当月全部接口的付费调用次数统计，达到更高档位时按更高档位计算
总折扣上限：VIP 折扣 + 量折扣合计不超过 50%
最低利润率保护：折后价不得低于成本价 × (1 + 15%)；若接口售价本身低于该保护价，则取消折扣并按售价计费
余额不足时调用将失败，请及时充值。
扣费公式：实际扣费 = 接口单价 × (1 - VIP 折扣比例 - 量折扣比例)，并受总折扣上限和最低利润率保护约束
VIP 折扣： 个人版9折 专业版8折 企业版7折
量折扣： 月付费调用 ≥1000 次享 2%、 月付费调用 ≥10000 次享 5%、 月付费调用 ≥20000 次享 10%
· 量折扣按账号当月全部接口的付费调用次数统计，达到更高档位时按更高档位计算
总折扣上限：VIP 折扣 + 量折扣合计不超过 50%
最低利润率保护：折后价不得低于成本价 × (1 + 15%)；若接口售价本身低于该保护价，则取消折扣并按售价计费
余额不足时调用将失败，请及时充值。
VIP 权益对比
| 等级 | 每月免费次数 | 本接口月免费上限 | 折扣 | VIP 折后单价 |
|---|---|---|---|---|
| 免费版 | 按接口配置 | — | - | ¥0.002/次 |
| 个人版 | 5000 次 | 5000 次 | 10% | ¥0.0018/次 |
| 专业版 | 30000 次 | 30000 次 | 20% | ¥0.0016/次 |
| 企业版推荐 | 200000 次 | 200000 次 | 30% | ¥0.0014/次 |
* VIP 月度免费额度每月重置。每月免费次数为账号级 VIP 月额度，本接口月免费上限为其中对本接口的限制（接口可单独设置上限或关闭）。VIP 折扣仅适用于余额扣费方式，VIP 折后单价不含量折扣。
本接口已关闭接口级月度免费额度（不影响 VIP 月度免费额度）。接口每日免费额度已关闭。
费用计算示例
* 以下示例未包含量折扣，量折扣按账号当月全部接口的付费调用量另行计算。
示例1：普通用户按次付费
调用 1000 次，费用 = 0.002 × 1000 = ¥2.00
示例2：个人版用户按次付费（仅 VIP 折扣，已考虑最低利润率保护）
调用 1000 次，折扣约 10%，费用 = 0.002 × (1 - 10%) × 1000 ≈ ¥1.80
错误码说明
本接口未定义专属错误码，调用时请参考通用错误码体系。
查看通用错误码参考
| 错误码 | 说明 | 解决方案 |
|---|---|---|
| 200 | 请求成功 | - |
| 400000 | 请求参数错误 | 检查参数名、格式与取值 |
| 401000 | 认证失败 | 检查 Authorization: Bearer 密钥是否正确、是否过期 |
| 401002 | 缺少 API 认证参数 | 请求未携带 key，请通过 URL 参数 key 或请求头 Authorization 传递密钥 |
| 402000 | 账户余额不足 | 充值后重试 |
| 403000 | 无访问权限 | 确认密钥权限、接口范围与 IP 白名单是否满足要求 |
| 404001 | 接口或端点不存在 | 检查 API 与端点的请求路径 |
| 409000 | 请求冲突 | 请稍后重试 |
| 422000 | 参数校验失败 | 检查参数格式与取值 |
| 429001 | 请求频率超限（QPS） | 降低请求频率，或升级套餐提升额度 |
| 429002 | 分钟级调用频率超限 | 降低调用频率，或升级套餐提升额度 |
| 429003 | 小时级调用额度已用完 | 升级套餐提升额度，或整点后重试 |
| 429004 | 今日调用额度已用完 | 升级套餐提升额度，或次日重试 |
| 500000 | 服务器内部错误 | 携带响应中的 request_id 联系技术支持 |
| 502000 | 服务暂时不可用 | 稍后重试 |
| 503000 | 服务暂时不可用 | 稍后重试 |
| 504000 | 请求超时 | 稍后重试 |
更新日志
暂无更新日志