API开放接口文档 - 卡BIN详情查询接口

收费标准

🎉

完全免费

CardBIN API 目前对所有用户完全免费开放，无需支付任何费用，无隐藏收费，也无调用次数限制（合理使用范围）。

🔑 免费接口调用 Token

U5E2X8C8L6C6I0Q5M1V7V6C5X7K3M9G0

✅

允许用于商业用途

您可以将本 API 集成到商业项目中，无需额外付费或申请授权。

📢

未来计划

未来若推出付费计划，将提前30天通过官网及邮件通知。

技术支持

如在使用过程中遇到任何问题，欢迎扫码添加技术支持微信，获取一对一帮助。

微信扫码联系，我们将在工作时间内快速响应。

联系我们

如有任何问题或建议，欢迎通过我们的官方网站留言反馈：

https://cardbin.cn/contact.html

您也可以在页面中填写姓名、邮箱及留言内容，我们会尽快与您取得联系。

接口概述

CardBIN API 提供银行卡 BIN 号详细信息查询服务，包括卡组织、卡品牌、卡类型、发卡行及国家信息。本文档介绍了如何快速接入并使用我们的 API 服务。

所有接口均采用 RESTful 风格设计，使用标准 HTTP 方法，返回 JSON 格式数据。

基础 URL

https://cardbin.cn/api/v1

认证方式

所有 BIN 查询接口均需要通过 Token 认证。请在请求头中添加 X-API-Token 字段。

请求头参数

参数名	类型	必填	说明
X-API-Token	string	是	API 认证 Token

请求示例

GET /api/v1/bin/detail/424242
Host: cardbin.cn
X-API-Token: your_api_token_here

cURL 示例

curl -X GET "https://cardbin.cn/api/v1/bin/detail/424242" \
  -H "X-API-Token: your_api_token_here"

响应格式

所有接口统一返回以下 JSON 格式：

{
  "code": 0,
  "message": "请求成功",
  "data": { ... }
}

字段	类型	说明
code	integer	业务状态码，0 表示成功，其他表示异常
message	string	提示信息
data	object/null	响应数据，失败时为 null

业务状态码

采用五位数编码规则：

状态码	说明	HTTP 状态码
0	请求成功	200
40001	请求参数错误	400
40101	认证失败（Token 无效或缺失）	401
40400	接口不存在	404
40401	资源不存在	404
50000	服务器内部错误	500
50001	业务查询失败	500

查询卡 BIN 详情

查询银行卡 BIN 号详细信息，包括卡组织、卡品牌、卡类型、发卡行及国家信息。

GET /api/v1/bin/detail/{bin}

请求参数

参数	类型	必填	说明	示例
bin	string	是	银行卡 BIN 号（路径参数），至少 6 位数字	424242

成功响应示例 (HTTP 200)

{
  "code": 0,
  "message": "请求成功",
  "data": {
    "bin": "424242",
    "scheme": "VISA",
    "brand": "VISA",
    "brand_zh": "维萨",
    "type": "CREDIT",
    "type_zh": "信用卡",
    "category": "CLASSIC",
    "category_zh": "普通卡",
    "issuer": {
      "name": "BANK OF AMERICA",
      "name_zh": "美国银行",
      "phone": "+1-800-421-2110",
      "url": "https://www.bankofamerica.com",
      "bank_id": "123"
    },
    "country": {
      "code": "US",
      "name": "United States",
      "name_zh": "美国"
    }
  }
}

响应字段说明

data 对象

字段	类型	说明
bin	string	BIN 号
scheme	string	卡组织，如 VISA、MASTERCARD
brand	string	卡品牌（英文）
brand_zh	string	卡品牌（中文）
type	string	卡类型，如 CREDIT、DEBIT
type_zh	string	卡类型中文
category	string	卡级别，如 CLASSIC、GOLD
category_zh	string	卡级别中文

data.issuer 对象

字段	类型	说明
name	string	发卡行名称（英文）
name_zh	string	发卡行名称（中文）
phone	string	客服电话
url	string	官网 URL
bank_id	string	发卡行 ID

data.country 对象

字段	类型	说明
code	string	国家二字代码，如 US、CN
name	string	国家名称（英文）
name_zh	string	国家名称（中文）

错误响应示例

认证失败 (HTTP 401)

{
  "code": 40101,
  "message": "认证失败，请提供有效的API Token",
  "data": null
}

BIN 号无效 (HTTP 400)

{
  "code": 40001,
  "message": "BIN号无效，至少需要6位数字",
  "data": null
}

BIN 未找到 (HTTP 404)

{
  "code": 40401,
  "message": "未找到该BIN号记录",
  "data": null
}

服务器错误 (HTTP 500)

{
  "code": 50001,
  "message": "查询失败: 错误详情",
  "data": null
}

API 开放接口文档