使用信用卡验证器 - BIN 检查 API

您需要快速验证卡片详细信息，减少欺诈尝试，并正确路由支付——所有这些都无需构建完整的卡片智能堆栈。在本文结束时，您将能够使用 Zyla API Hub 上的信用卡验证器 - BIN 检查 API 验证信用卡的 BIN（前 6 位数字）并读取发卡行、品牌、类型和国家信号。

此 API 的功能及使用时机

信用卡验证器 - BIN 检查 API 允许您验证信用卡的 BIN（前六位数字）并检索对财务和支付工作流有用的结构化数据点。通过单个 GET 请求，您可以了解 BIN 是否有效，并接收诸如卡片品牌、卡片类型、级别、发卡行名称（如可用）和发卡国信号等数据。典型用途包括：

在结账流程中进行预验证，以减少交易生命周期后期的拒绝。
根据品牌或发卡行区域进行 PSP 或收单方选择的路由逻辑。
将 BIN 情报与地理位置、设备和速度检查相结合的风险和欺诈评分管道。
对存储的支付方式进行丰富，以支持客户服务或分析仪表板。

您可以在 Zyla API Hub 上浏览更多财务和支付 API，该平台提供一个帐户、一个 API 密钥和覆盖数千个 API 的订阅模型。

在 Zyla API Hub 上入门

要在本周内完成您的集成：

打开 API 列表：开始 7 天试用信用卡验证器 - BIN 检查 API。
点击订阅或开始免费试用（如可用）以获取您的 API 密钥。Zyla 使用订阅 + 配额，而不是按调用计费。
使用头部 Authorization: Bearer YOUR_API_KEY 进行请求身份验证。

访问选项通常包括 7 天试用或首次 API 的 50 次请求；请查看 API 页面以获取当前访问选项和定价。

端点参考

信用卡验证器 - BIN 检查 API 在 Zyla 上公开了一个端点：

BIN 检查器
方法：GET
URL：https://zylalabs.com/api/40/credit-card-validator-bin-checker-api/1885/bin-checker
目的：根据前六位数字（BIN/IIN）验证信用卡并接收卡片和发卡行详细信息。
所需查询参数：
- bin（字符串，必需）：卡号的前 6 位数字。示例：346350

响应指示 BIN 是否有效，并返回相关元数据，如品牌、类型、级别、发卡行数据和国家信息（如可用）。

您现在可以运行的 cURL 复制粘贴

将 YOUR_API_KEY 替换为您 Zyla 仪表板上的密钥并执行：

curl -s -X GET "https://zylalabs.com/api/40/credit-card-validator-bin-checker-api/1885/bin-checker?bin=346350" \
-H "Authorization: Bearer YOUR_API_KEY"

官方 JSON 响应示例

这是 BIN 检查端点的官方示例有效负载。您的实际值将取决于您查询的 BIN。

{
"status": 200,
"success": true,
"isValid": true,
"message": "The BIN number is valid.",
"data": {
"bin_iin": "346350",
"card_brand": "AMERICAN EXPRESS",
"card_type": "CREDIT",
"card_level": "------",
"issuer_name_bank": "------",
"issuer_bank_website": "API Only",
"issuer_bank_phone": "API Only",
"iso_country_name": null,
"iso_country_code": null
}
}

字段说明：

status：包含在主体中的 HTTP 风格状态代码。
success：指示请求成功的布尔值。
isValid：BIN 是否被识别为有效。
message：人类可读的状态消息。
data.bin_iin：回显您查询的 BIN。
data.card_brand：方案/网络（例如，AMERICAN EXPRESS、VISA、MASTERCARD）。
data.card_type：CREDIT/DEBIT 或类似分类。
data.card_level：如果可用，产品级别（例如，白金）。破折号表示未提供。
data.issuer_name_bank / issuer_bank_website / issuer_bank_phone：发卡行元数据（如可用）。“仅 API”或破折号表示通过 API 可用。
data.iso_country_name / iso_country_code：国家元数据（如可用）；未提供时为 null。

相同响应（紧凑形式）

以下是相同示例的单行形式，适用于日志快照或测试：

{"status":200,"success":true,"isValid":true,"message":"The BIN number is valid.","data":{"bin_iin":"346350","card_brand":"AMERICAN EXPRESS","card_type":"CREDIT","card_level":"------","issuer_name_bank":"------","issuer_bank_website":"API Only","issuer_bank_phone":"API Only","iso_country_name":null,"iso_country_code":null}}

Python 示例：查询 BIN 并根据结果分支

以下 Python 代码片段调用端点，检查有效性，并提取一些高价值字段以进行路由或风险决策。

import requests

API_KEY = "YOUR_API_KEY"
BIN = "346350"

url = "https://zylalabs.com/api/40/credit-card-validator-bin-checker-api/1885/bin-checker"
headers = {
"Authorization": f"Bearer {API_KEY}"
}
params = {"bin": BIN}

resp = requests.get(url, headers=headers, params=params, timeout=10)
resp.raise_for_status()
data = resp.json()

if not data.get("success"):
raise RuntimeError(f"BIN check failed: {data}")

is_valid = data.get("isValid")
message = data.get("message")
card_info = data.get("data", {}) or {}

brand = card_info.get("card_brand")
card_type = card_info.get("card_type")
issuer = card_info.get("issuer_name_bank")
country_code = card_info.get("iso_country_code")

print(f"isValid={is_valid} message={message}")
print(f"brand={brand} type={card_type} issuer={issuer} country={country_code}")

# 示例分支：
if is_valid and brand == "AMERICAN EXPRESS":
# 路由到特定的收单方或 PSP 以获取 Amex
pass
elif is_valid and card_type == "DEBIT":
# 应用不同的 SCA 逻辑或风险权重
pass
else:
# 对于无效或未知的 BIN 进行回退处理
pass

您可能会使用的字段映射

data.card_brand → 支付路由、附加费规则或 UI 调整（例如，显示品牌徽标）。
data.card_type → 信用卡与借记卡的风险政策差异。
data.issuer_name_bank → 客户服务工具或基于发卡行的路由。
data.iso_country_code → 基于区域的合规性、3DS 与非 3DS 流程，以及 KYC 启发式。

许多团队仅保留这些字段的子集，特别是品牌、类型和国家代码，以及 BIN 以便后续丰富。

幂等性、重试和缓存

幂等性：GET 在传输错误时可以安全重试。添加回退和抖动。
缓存：BIN 元数据变化不频繁。按 BIN 缓存响应（例如，24 小时或您的操作政策）以减少延迟和调用。
处理 null：某些字段可以为 null 或被屏蔽（例如，“仅 API”）。将缺失值视为未知，避免脆弱的假设。
配额：Zyla 使用订阅 + 配额。请查看 API 页面以获取您计划的分配和当前访问选项。

现实世界的金融用例

结账 BIN 预检查：当客户输入六位数字时，查询 API 并决定是否显示特定于 Amex 的 CVV 提示或不同的 SCA 路径。
收单方选择：根据品牌或发卡行区域优先选择不同的收单方，以优化批准率。
欺诈防御：标记不匹配的区域（例如，BIN 国家与发货 IP 国家）以进行增强验证。
客户支持：当支付失败时，根据 BIN 显示检测到的品牌和发卡行以加快分类。

合同示例（用于测试和模拟）

在编写合同测试时，您可以针对这个已知的良好结构进行断言，以确保解析器和下游验证器的稳定性。

{
"status": 200,
"success": true,
"isValid": true,
"message": "The BIN number is valid.",
"data": {
"bin_iin": "346350",
"card_brand": "AMERICAN EXPRESS",
"card_type": "CREDIT",
"card_level": "------",
"issuer_name_bank": "------",
"issuer_bank_website": "API Only",
"issuer_bank_phone": "API Only",
"iso_country_name": null,
"iso_country_code": null
}
}

通过 MCP 从 AI 代理调用 API

您可以在支持模型上下文协议（MCP）的 AI 编码环境中协调此 API，例如 Claude Code、Cursor 或 Windsurf。Zyla MCP 端点集中访问您使用 Zyla 密钥订阅的任何 API。

端点：MCP
方法：使用 Zyla MCP 端点和您的密钥配置您的 MCP 兼容客户端。指示代理执行 HTTP GET 到 BIN 检查器 URL，并将 Authorization 头设置为 Bearer YOUR_API_KEY 和查询参数 bin=346350。
验证：解析 isValid 和数据字段以指导代理逻辑（例如，向开发人员解释根据品牌使用哪个收单方路由）。

由于 MCP 集中管理凭据，您可以避免在提示中嵌入密钥，并保持跨工具的一致调用。

操作检查清单

安全性：绝不要记录完整的 PAN。您只需要前六位数字（BIN）即可使用此 API。
超时：设置合理的超时（例如，5-10 秒）。仅在瞬态网络错误时重试。
可观察性：记录请求 ID、BIN 和响应摘要（状态、成功、isValid、品牌、类型）。避免记录超出政策要求的 PII。
弹性：如果字段为 null，则默认使用保守流程（例如，要求 3DS 或增强验证）。
发布：功能标记 BIN 限制规则，以便产品团队可以在不重新部署的情况下调整逻辑。

故障排除和验证

如果您遇到意外的 null 或被屏蔽的值，请确认您的集成是否正确读取 JSON，而不是假设缺失字段。使用已知的良好示例来验证您的解析器：

{
"status": 200,
"success": true,
"isValid": true,
"message": "The BIN number is valid.",
"data": {
"bin_iin": "346350",
"card_brand": "AMERICAN EXPRESS",
"card_type": "CREDIT",
"card_level": "------",
"issuer_name_bank": "------",
"issuer_bank_website": "API Only",
"issuer_bank_phone": "API Only",
"iso_country_name": null,
"iso_country_code": null
}
}

常见检查：

头部拼写：确保“Authorization: Bearer YOUR_API_KEY”是准确的。
查询参数：键必须是“bin”，值必须仅为前六位数字。
HTTP 方法：此端点必须为 GET。

端到端示例流程

用户输入卡号；一旦出现六位数字，提取 BIN。
使用 ?bin=346350 和您的 Authorization 头 GET BIN 检查器端点。
在响应中：如果成功且 isValid：
- 存储品牌和类型以进行路由和 UI。
- 如果品牌是 AMERICAN EXPRESS，调整 CVV 标签和收单方路由。
- 如果 iso_country_code 为 null，则不要假设国内路由；将其视为未知。
如果无效，尽早提示用户或请求替代支付方式。
按 BIN 缓存响应以减少重复查找。

另一个官方 cURL 和 JSON 配对以快速测试

使用此确切请求并期望以下相同形状（值对于其他 BIN 会有所不同）：

curl -s -X GET "https://zylalabs.com/api/40/credit-card-validator-bin-checker-api/1885/bin-checker?bin=346350" \
-H "Authorization: Bearer YOUR_API_KEY"

{
"status": 200,
"success": true,
"isValid": true,
"message": "The BIN number is valid.",
"data": {
"bin_iin": "346350",
"card_brand": "AMERICAN EXPRESS",
"card_type": "CREDIT",
"card_level": "------",
"issuer_name_bank": "------",
"issuer_bank_website": "API Only",
"issuer_bank_phone": "API Only",
"iso_country_name": null,
"iso_country_code": null
}
}