检查卡的 API

您需要快速验证支付卡，理想情况下是在收费或路由交易之前。在本指南结束时，您将拥有一个有效的调用，该调用检查卡的 BIN（前 6 位数字），并使用 Zyla API Hub 上的单个金融 API 返回品牌、类型、级别、发行者和国家——准备好今天将其粘贴到您的集成中。

此 API 的功能及使用时机

卡检查 API 验证 6 位数字的 BIN，并返回卡片元数据，例如品牌（例如，MASTERCARD）、类型（信用卡/借记卡）、级别（例如，黄金）、发行者名称和发行者国家。应用程序使用此功能来：

• 在授权之前拒绝不支持的卡品牌或类型。
• 根据发行者国家将交易路由到正确的处理器。
• 为客户支持或合规检查预填发行者信息。
• 通过验证 BIN 的合法性来增强欺诈检查。

Zyla API Hub 将数千个金融和支付 API 集中在一个帐户、一个 API 密钥和一个订阅模型下。您可以从 zylalabs.com 的开发者仪表板管理您的访问和使用情况。

在 Zyla API Hub 上入门

要快速集成：

1. 打开 Zyla 上的卡检查 API 页面：开始 7 天的卡检查 API 试用。
2. 点击订阅（或在可用时点击开始免费试用）。对于此 API，第一次 API 提供 7 天的试用或 50 次请求。
3. 从您的仪表板复制您的 API 密钥。身份验证通过 HTTP 头进行：Authorization: Bearer YOUR_API_KEY。

计费是订阅 + 配额（不是按调用付费）。没有免费计划。有关当前访问选项和定价，请查看 Zyla 上的 API 页面。

您将调用的端点

卡检查 API 提供一个简单的端点，用于验证 BIN 并返回卡片详细信息。所有请求都是 GET，并使用您的 Bearer 令牌进行身份验证。

检查卡

• 方法：GET
• URL：https://zylalabs.com/api/2333/card-checker-api/2243/check-card
• 所需查询参数：
  • bin（数字）：卡的前 6 位数字。示例：444444

它的功能：验证提供的 BIN 并返回一个 JSON 负载，其中包含验证状态和卡片元数据（品牌、类型、级别、发行者和国家）。

您可以粘贴并运行的 cURL

将 YOUR_API_KEY 替换为您 Zyla 仪表板中的密钥，并在终端中运行：

curl -s -X GET "https://zylalabs.com/api/2333/card-checker-api/2243/check-card?bin=444444" \
-H "Authorization: Bearer YOUR_API_KEY"

官方示例响应

{
"status": 200,
"success": true,
"isValid": true,
"message": "BIN 号码有效。",
"data": {
"bin_iin": "557829",
"card_brand": "MASTERCARD",
"card_type": "CREDIT",
"card_level": "GOLD",
"issuer_name_bank": "AKBANK T.A.S.",
"issuer_bank_website": "------",
"issuer_bank_phone": "4442525",
"iso_country_name": "TURKEY",
"iso_country_code": "TR"
}
}

您通常会使用的字段：

• status：在负载中返回的类似 HTTP 的状态代码（200 表示成功）。
• success：API 操作的布尔成功指示器。
• isValid：BIN 是否被识别为有效。
• message：可读的验证结果。
• data.bin_iin：API 返回的标准化 BIN/IIN。
• data.card_brand：卡网络（例如，MASTERCARD、VISA 等）。
• data.card_type：信用卡/借记卡（用于路由或费用计算）。
• data.card_level：例如，黄金、白金（有时用于福利逻辑）。
• data.issuer_name_bank：发行银行名称。
• data.issuer_bank_phone：发行者电话（用于支持工作流）。
• data.iso_country_name / data.iso_country_code：发行国家（例如，TR 表示土耳其）。

Python 示例：验证 BIN 和分支逻辑

此示例调用相同的端点，并使用响应字段仅允许在特定国家发行的 MASTERCARD 信用卡。根据您的需要调整逻辑。

import os
import requests

API_KEY = os.getenv("ZYLA_API_KEY", "YOUR_API_KEY")
BIN = "444444" # 卡的前 6 位数字

url = "https://zylalabs.com/api/2333/card-checker-api/2243/check-card"
params = {"bin": BIN}
headers = {"Authorization": f"Bearer {API_KEY}"}

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

if not data.get("success"):
raise RuntimeError(f"卡检查失败：{data}")

if not data.get("isValid"):
print("BIN 无效。阻止或回退。")
else:
meta = data.get("data", {})
brand = meta.get("card_brand")
ctype = meta.get("card_type")
country = meta.get("iso_country_code")
issuer = meta.get("issuer_name_bank")

print(f"BIN 有效。品牌={brand}，类型={ctype}，发行者={issuer}，国家={country}")

# 示例策略：仅接受来自 TR 的 Mastercard 信用卡
if brand == "MASTERCARD" and ctype == "CREDIT" and country == "TR":
print("继续授权流程。")
else:
print("根据业务规则进行不同路由或拒绝。")

节省时间的实用集成说明

• BIN 长度：仅需要前 6 位数字（端点期望 6 位数字）。
• 何时调用：在收集卡片数字后尽早运行检查，在向您的 PSP 提交授权之前。
• 缓存：BIN 到元数据的映射变化不频繁。缓存成功的响应（例如，24 小时到 7 天），以减少延迟和配额使用，并按 BIN 使其失效。
• 隐私：您永远不会将完整的 PAN 发送到此 API——仅发送 BIN。这减少了您服务中敏感数据处理的范围。
• 超时和重试：使用合理的客户端超时（例如，5–10 秒）。对于瞬态网络问题，通常在回退到默认流程之前，单次重试带有抖动通常就足够了。
• 配额：此 API 采用订阅 + 配额模型（不是按调用付费）。在您的 Zyla 仪表板中监控您的使用情况，并批量或缓存以保持在计划限制内。
• 故障处理：如果成功为 false 或请求失败，请决定是否允许最佳努力授权或要求支持的网络/类型。记录负载以供审计。
• 审计：持久化您依赖的 BIN 和响应数据字段（品牌、类型、发行者、国家），与您的支付尝试记录一起，以便追溯。

端到端流程示例

1. 客户在您的结账表单中输入卡号。
2. 您的前端提取前六位数字（BIN）并通过 TLS 将其发送到您的后端。
3. 您的后端使用该 BIN 调用卡检查 API。
4. 如果 isValid 为 true，使用 card_brand、card_type 和 iso_country_code 选择处理器路由或强制政策（例如，仅允许信用卡）。
5. 缓存 BIN 结果。根据需要继续授权或 3DS 流程。

您本周可以交付的用例

• 卡片接受门控：尽早阻止不支持的品牌或类型，以减少下游网关拒绝。
• 基于地理的路由：使用 iso_country_code 将交易发送到针对发行者国家优化的处理器。
• 费用计算：根据 card_type 或 card_level（例如，黄金/白金）在您的定价逻辑中区分费用。
• 支持工具：向代理显示 issuer_name_bank 和电话，以加快升级。
• 风险规则：将 BIN 有效性与设备、IP 和速度检查结合起来，以提高或降低摩擦。

与 AI 代理一起使用 Zyla MCP 端点

如果您使用 AI 编码环境或代理（例如，Claude Code、Cursor、Windsurf），您可以通过 MCP 桥接调用 Zyla API。配置您的客户端以连接到 Zyla MCP 端点并提供您的 API 密钥。了解更多信息：MCP。从那里，代理可以在后台调用相同的检查卡端点，带有 bin 参数和您的 Bearer 令牌。

这使您能够原型提示，例如“验证 BIN 444444 并告诉我发行者的国家”，并将结果直接连接到您的代码生成或运行手册中——无需离开您的 IDE。

测试清单

• 快乐路径：已知有效的 BIN 返回 success=true 和 isValid=true，并带有完整的数据字段。
• 无效输入：非数字或错误长度的输入被拒绝或返回 isValid=false（在您的 UI 中优雅处理）。
• 政策分支：确认您的品牌/类型/国家规则在接受和路由结果中正确反映。
• 缓存：验证对同一 BIN 的重复检查命中缓存并减少外部调用。
• 可观察性：记录状态、isValid 和关键数据字段；添加缓存命中率和 API 错误的指标。

参考：端点摘要

• 检查卡（GET）：https://zylalabs.com/api/2333/card-checker-api/2243/check-card
  • 所需参数：bin（数字）
  • 身份验证：Authorization: Bearer YOUR_API_KEY
  • 返回：状态、成功、isValid、消息，以及带有 BIN/IIN 元数据（品牌、类型、级别、发行者、国家）的数据

为什么选择 Zyla API Hub 进行金融集成

通过一个帐户和一个密钥访问超过 10,000 个公共 API，Zyla 减少了多个集成的团队的开销。您可以订阅卡检查 API，并随着您的堆栈演变将其与其他金融和支付工具叠加，所有这些都可以在 zylalabs.com 的 Zyla 仪表板上完成。

常见问题

我可以验证完整的 PAN 还是仅验证 BIN？
此端点仅验证 6 位数字的 BIN。请勿发送完整的 PAN。使用您的支付网关进行 PAN 级验证和授权。

我使用哪个头进行身份验证？
每个请求都发送 Authorization: Bearer YOUR_API_KEY。

如果 BIN 无效会发生什么？
响应将指示 isValid 为 false（如果调用执行，success 可能仍为 true）。使用该信号调整您的流程，例如，阻止卡或请求替代支付方式。

我可以发出多少请求？
Zyla 使用订阅 + 配额（不是按调用付费）。对于第一个 API，有 7 天的试用或 50 次请求。请查看 API 页面以获取当前限制和定价。

我可以从 AI 代理调用此 API 吗？
是的。将您的代理连接到 Zyla MCP 端点，并使用您的 API 密钥进行身份验证。代理可以使用 bin 参数调用检查卡端点。

交付您的集成

验证 BIN，智能路由交易，并通过一次调用减少可避免的拒绝。从这里开始并获取您的密钥：开始 7 天的卡检查 API 试用。一旦订阅，使用上面的 GET 端点和您的 Bearer 令牌，立即交付您的金融工作流。