如何使用卡片检查API

您的结账需要在您接触支付通道之前标记坏的BIN。在本指南结束时，您将验证BIN，并立即读取卡片品牌、类型、级别、发行者和国家，只需向Zyla API Hub的卡片检查API发送一次HTTP GET请求——准备好今天将其粘贴到您的后端中。

此API为您提供的内容

卡片检查API返回卡片BIN（银行识别号码；前6位数字）的验证和您可以立即用于路由、欺诈筛查和用户体验的丰富字段：

• isValid和message以确认提供的BIN是否被识别
• card_brand（例如，MASTERCARD）、card_type（CREDIT/DEBIT）和card_level（例如，GOLD）
• issuer_name_bank、issuer_bank_phone、issuer_bank_website
• iso_country_name和iso_country_code

这是一个单一的端点，具有一个必需的参数，旨在快速集成到财务流程中，如结账、PSP路由、基于BIN的规则和特定于发行者的客户消息。

在Zyla API Hub上开始

Zyla API Hub将超过10,000个公共API聚合到一个帐户、一个API密钥和一个订阅+配额模型下。要开始使用此财务API：

1. 打开卡片检查API页面并订阅。列表上有7天的试用期。请查看API页面以获取当前访问选项和定价。
2. 复制您的API密钥。
3. 使用Authorization: Bearer YOUR_API_KEY头调用端点。

开始7天的卡片检查API试用

端点概述

卡片检查API有一个端点：

• 方法：GET
• URL：https://zylalabs.com/api/2333/card-checker-api/2243/check-card
• 必需的查询参数：
  • bin（数字）：一个6位数字的BIN。示例：444444
• 认证：Authorization: Bearer YOUR_API_KEY

成功时，响应包括顶级状态、成功、isValid、消息和一个包含发行者和卡片属性的数据对象。

您现在可以运行的cURL

将YOUR_API_KEY替换为您从Zyla API Hub获得的密钥并运行：

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"
}
}

您实际会使用的字段说明：

• isValid和message：在进一步处理之前的快速验证门
• data.card_brand / data.card_type / data.card_level：路由规则、用户体验徽章、费用逻辑
• data.issuer_name_bank和data.issuer_bank_phone：发行者感知的支持流程
• data.iso_country_code / data.iso_country_name：区域逻辑、监管检查、SCA提示

Python示例（requests）

此示例调用相同的端点，检查有效性，并根据品牌/类型进行路由逻辑分支。

import os
import requests

API_KEY = os.getenv("ZYLA_API_KEY", "YOUR_API_KEY")
BIN = "444444"

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=15)
resp.raise_for_status()
data = resp.json()

# 基本保护措施
if not data.get("success"):
raise RuntimeError(f"查找失败：{data}")

if not data.get("isValid"):
print(f"BIN {BIN} 无效：{data.get('message')}")
else:
card = data.get("data", {})
brand = card.get("card_brand")
ctype = card.get("card_type")
level = card.get("card_level")
issuer = card.get("issuer_name_bank")
country = card.get("iso_country_code")

print(f"BIN {BIN} 是有效的：{brand} {ctype} {level} 由 {issuer} ({country}) 发行")

# 示例路由逻辑
if brand == "MASTERCARD" and ctype == "CREDIT":
# 路由到特定处理器或应用费用/限制
pass

# 示例用户体验逻辑
if country == "TR":
# 为土耳其卡提供本地化副本或SCA提示
pass

节省时间的实施技巧

• 仅限服务器端调用。切勿在客户端代码中暴露您的API密钥。
• 缓存BIN结果一段时间，以减少结账时的延迟。BIN数据变化不频繁，但始终设计为重新验证。
• 验证输入长度：在调用API之前，仅接受6个数字的BIN。
• 使用isValid作为第一个分支：如果为false，则快速失败并提示用户重新检查其卡号。
• 幂等性：此GET请求在瞬态网络问题上是安全的重试。

现实世界的金融用例

• 结账预验证：在您初始化支付意图之前检测明显错误的BIN。
• 处理器路由：按card_brand或card_type路由以优化授权率或费用。
• 风险和合规：使用iso_country_code触发逐步身份验证或根据政策要求拒绝风险走廊。
• 发行者感知的用户体验：在支持流程中显示issuer_name_bank或提供issuer_bank_phone。
• 支付方式控制：使用card_level在适用的情况下阻止不支持的组合（例如，在某些产品线上的企业CREDIT）。

通过MCP从AI代理调用

如果您希望将其集成到AI开发工具中（Claude Code、Cursor、Windsurf或任何MCP兼容客户端），请将客户端指向Zyla MCP端点，并使用您的Zyla API密钥。然后，您的代理可以在后台调用相同的卡片检查API功能。

• MCP端点：MCP
• API密钥：根据您的MCP客户端配置传递您的Zyla API密钥
• 调用语义：对check-card路径执行相同的GET请求，带有bin参数

这使您的工作流程保持在IDE中，同时仍使用相同的Authorization: Bearer YOUR_API_KEY头和上面显示的确切请求URL。

测试清单

• 返回形状：在使用值之前确认status、success、isValid、message和data.*字段的存在。
• 输入验证：在访问网络之前拒绝非数字或非6位数字的BIN。
• 超时：设置合理的HTTP客户端超时（例如，10-15秒），并仅在幂等的GET请求上重试。
• 可观察性：记录顶级状态和isValid以进行分类；避免记录完整的PAN——仅记录前6位数字以进行BIN检查。
• 缓存：按BIN缓存；在部署时或在适合您风险姿态的时间窗口后使其失效。

常见问题解答

端点需要什么参数？
一个查询参数：bin（6位数字）。示例：bin=444444。

确切的端点和方法是什么？
GET https://zylalabs.com/api/2333/card-checker-api/2243/check-card

我如何进行身份验证？
在请求头中发送Authorization: Bearer YOUR_API_KEY。请从Zyla API Hub订阅页面获取此API的密钥。

返回哪些字段？
顶级状态、成功、isValid、消息和一个包含bin_iin、card_brand、card_type、card_level、issuer_name_bank、issuer_bank_website、issuer_bank_phone、iso_country_name和iso_country_code的数据对象。

是否有免费计划？
没有免费计划。列表上有7天的试用期；请查看API页面以获取当前访问选项和定价。

今天就开始您的BIN验证。在卡片检查API列表上订阅，获取您的密钥，并将单个GET调用放入您的结账或风险管道中：开始7天的卡片检查API试用。然后，随着您的路线图的增长，扩展到Zyla API Hub的其余财务目录。