银行卡归属地查询指南总目录（apiCode=30）

# 银行卡归属地查询指南总目录（apiCode=30） > 接口：银行卡归属地查询（apiCode=30）· 接入点：`30-7` 银行卡归属信息查询 · 请求方式：GET / POST · 返回格式：JSON · 计费：按次计费，5 厘/次，查询失败不计费 > 最后实测核对：2026-09-15 输入银行卡号，返回开户地区、银行名称、卡种、卡品牌、客服电话、官网、银行简码、规范化行名与银行标志；可选附带 BIN 码、BIN 码长度、卡号长度与银联 Luhn 效验结果。服务商为昆明秀派科技有限公司（官方自营），所属分类企业服务。 本系列共 10 篇，全部基于 2026-09-15 的真实调用实测与官方帮助手册整理。 ## 接口速览 | 项 | 值 | |------|------| | 接口编号 / 接入点 | `30` / `30-7`（全文只有这一个接入点） | | 接口地址 | `https://route.showapi.com/30-7?appKey={your_appKey}` | | 鉴权 | `appKey` 走 query 参数 | | 请求参数 | `cardNum`（必填）、`needBin`（可选） | | 计费 | 5 厘/次；专用资源包 50 元档对应本接入点 1 万次；查询失败不计费 | | 并发 | 10 次/秒 | | 数据更新 | 每年不定期更新 | | 枚举规模 | `formatBankName` 249 项 / `area` 646 项 / `brand` 1929 项 | | 集成方式 | MCP 服务（接口级）、OpenAPI 3.0 文档（接口级）、在线调试 | ## 全系列文章 ### 入门 **1. [银行卡归属地查询：用 Python 跑通 30-7 接口的第一条请求](https://www.showapi.com/guides/bank-card-attribution-quickstart-30)** 从注册取 AppKey 到拿到第一条结果，含 Python、cURL、Node.js 三份代码与真实返回 JSON。适合第一次接入。 **2. [银行卡归属地查询返回字段逐个说清：ret_code、area、brand 与 formatBankName 怎么读](https://www.showapi.com/guides/bank-card-attribution-response-fields-30)** 15 个业务字段逐个说明：哪个一定返回、哪个条件返回、哪个可能为空字符串、返回体里还有哪些实测观察到的字段。适合做字段映射时对照。 ### 参数与排错 **3. [银行卡归属地查询的 cardNum 与 needBin 怎么传：什么时候才需要 BIN 与 Luhn 效验](https://www.showapi.com/guides/bank-card-attribution-params-guide-30)** 两个业务参数的取值、组合建议，以及 `isLuhn` 三个取值（`1` / `0` / 空字符串）的业务含义。 **4. [银行卡归属地查询排错：外层 -1、body ret_code -1、remark 提示分别代表什么](https://www.showapi.com/guides/bank-card-attribution-error-codes-30)** 三种失败形态的完整实测报文与统一判定代码。只判 `ret_code` 会漏掉其中两种。 ### 参考 **5. [银行卡归属地查询枚举速查：249 个规范行名 / 646 个归属地 / 1929 个卡品牌](https://www.showapi.com/guides/bank-card-attribution-enum-reference-30)** 三组枚举全量清单，另含 `area` 一级行政区的 48 种写法分布、同一行政区的多种写法对照、二级为空的 30 个取值。做字典表和前端下拉时用这一篇。 ### 场景实战 **6. [支付收银台接入银行卡归属地查询：绑卡环节的校验链路怎么设计](https://www.showapi.com/guides/bank-card-attribution-payment-risk-30)** 表结构设计、查询时机取舍、三类返回结果对应的前端文案、风控侧字段用法。适合绑卡与风控场景。 **7. [代付与对账系统批量核对开户行：用银行卡归属地查询补全存量数据](https://www.showapi.com/guides/bank-card-attribution-payout-reconcile-30)** 存量卡号清洗流程、限流分批、人工复核队列、对账差异定位，含 10 万条任务的时间窗估算。适合代付与清结算场景。 ### 成本与选型 **8. [银行卡归属地查询按次计费下怎么省调用：缓存粒度怎么定与并发限流](https://www.showapi.com/guides/bank-card-attribution-cache-cost-30)** 成本模型、缓存粒度选择（含「不能按 BIN 前缀缓存」的实测依据）、Redis 设计、令牌桶限流写法。 **9. [银行卡归属地查询方案怎么选：自建 BIN 库、公开数据源、付费接口的适用条件](https://www.showapi.com/guides/bank-card-attribution-selection-30)** 三条路线的适用条件与能力对照表。不做「推荐谁」的结论，只给判断依据。 ### 工具与集成 **10. [在 AI 客户端和 Postman 里接入银行卡归属地查询：MCP 服务与 OpenAPI 文档配置](https://www.showapi.com/guides/bank-card-attribution-mcp-openapi-30)** MCP 配置 JSON、OpenAPI 文档的获取与导入步骤，以及只在 YAML 里才有的超时与鉴权定义。 ## 相关资源 | 资源 | 地址 | |------|------| | 接口详情页 | [https://www.showapi.com/apiGateway/view/30](https://www.showapi.com/apiGateway/view/30) | | 接入点 30-7 | [https://www.showapi.com/apiGateway/view/30/7](https://www.showapi.com/apiGateway/view/30/7) | | OpenAPI YAML | [https://www.showapi.com/openapi/market/30.yaml](https://www.showapi.com/openapi/market/30.yaml) | | MCP 服务 | `http://www.showapi.com.cn/mcp/30/{your_appKey}` | | AppKey 管理 | [https://www.showapi.com/console#/myApp](https://www.showapi.com/console#/myApp) | | 产品价格 | 接口页「产品价格」页签（档位与接入点单价表） | | 帮助手册 | 接口页「帮助手册」页签（三组枚举原文） | ## 阅读建议 **第一次接入。** 按 1 → 2 → 3 的顺序读：先把请求发通，再看清返回体的结构，最后按业务场景决定 `needBin` 传不传。 **已经在用，遇到问题。** 直接看 4。三种失败形态的判定逻辑能覆盖绝大多数「为什么没查到结果」的疑问。 **要做前端下拉或字典表。** 直接看 5，三组清单都在里面。 **评估要不要上这个接口。** 看 9 的适用条件对照表，再看 8 的成本模型。 **准备上线到批量任务。** 看 7，里面有限流、分批与时间窗的完整写法。 - **本系列共 10 篇**：本页即[银行卡归属地查询指南总目录](https://www.showapi.com/guides/bank-card-attribution-guides-30)