您需要快速验证卡片,而无需构建自己的 BIN 数据库或维护供应商抓取器。在本指南结束时,您将调用一个端点来检查卡片的 BIN,并读取品牌、类型、级别、发行者和国家等关键属性——准备好插入您的结账、风险规则或财务工作流程中。
使用简单的 BIN 检查可以做什么
卡片检查器 API 根据卡片的 BIN(银行识别号码)返回验证和元数据。通过一次请求,您可以了解该 BIN 是否有效,并获取字段,如 card_brand(例如,MASTERCARD)、card_type(例如,CREDIT)、card_level(例如,GOLD)、issuer_name_bank 和 iso_country_code。财务和支付团队使用此信息来:
- 在尝试授权之前预先验证卡片,以减少可避免的网关调用。
- 通过品牌、类型、级别、发行者或国家强制执行路由或风险政策。
- 通过发行者和国家详细信息增强交易日志,以便进行分析和对账。
- 构建客户支持工具,识别卡片属性而无需存储完整的 PAN。
该 API 列在 Zyla API Hub 上,这是一个拥有超过 10,000 个公共 API 的 API 市场。您将获得一个帐户、一个 API 密钥,以及您选择的 API 的订阅 + 配额模型——没有按调用付费的惊喜,也没有每个供应商的单独授权。
在 Zyla API Hub 上开始
打开卡片检查器 API 页面并订阅以获取您的密钥。该列表提供 7 天的试用期,以便您首先在自己的环境中进行测试。订阅后,您将拥有一个可以通过授权头在 Zyla 端点中使用的 API 密钥。
- 开始 7 天的卡片检查器 API 试用
- 访问中心主页以探索其他财务和支付 API:zylalabs.com
在 Zyla 上的身份验证非常简单:将 Authorization: Bearer YOUR_API_KEY 添加到您的请求中。计费是订阅 + 配额,而不是按调用付费。请查看 API 页面以获取当前访问选项和定价。
您将调用的端点
卡片检查器 API 暴露一个简单的端点来验证 BIN 并返回卡片元数据。
- 方法:GET
- URL:https://zylalabs.com/api/2333/card-checker-api/2243/check-card
- 所需查询参数:bin(数字)
描述:在 bin 参数中输入一个 6 位数字的 BIN 号码以验证并检索卡片详细信息。
cURL 示例(复制粘贴即可使用)
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:布尔值,指示提供的 BIN 是否被识别为有效。
- message:人类可读的验证状态。
- data.bin_iin:与结果关联的 BIN/IIN。
- data.card_brand、data.card_type、data.card_level:用于路由和 UI 标签的标识符。
- data.issuer_name_bank、issuer_bank_phone、issuer_bank_website:您可以存储以供参考的发行者详细信息。
- data.iso_country_name、data.iso_country_code:合规检查和欺诈规则的国家信息。
Python 示例:检查 BIN 并根据验证结果分支
下面的代码片段演示了一个简单的 GET 调用,解析响应,并显示在哪里插入您的策略逻辑(例如,拒绝预付信用卡,仅允许某些国家,或提示额外验证)。
import os
import requests
API_KEY = os.getenv("ZYLA_API_KEY", "YOUR_API_KEY")
BASE_URL = "https://zylalabs.com/api/2333/card-checker-api/2243/check-card"
def check_bin(bin_number: str) -> dict:
url = f"{BASE_URL}?bin={bin_number}"
headers = {"Authorization": f"Bearer {API_KEY}"}
resp = requests.get(url, headers=headers, timeout=10)
resp.raise_for_status()
return resp.json()
if __name__ == "__main__":
result = check_bin("444444")
# 您将常用的核心字段
is_valid = result.get("isValid")
message = result.get("message")
data = result.get("data", {}) or {}
print("BIN 有效:", is_valid)
print("消息:", message)
if is_valid:
brand = data.get("card_brand")
card_type = data.get("card_type")
level = data.get("card_level")
issuer = data.get("issuer_name_bank")
country_code = data.get("iso_country_code")
print("品牌:", brand)
print("类型:", card_type)
print("级别:", level)
print("发行者:", issuer)
print("国家:", country_code)
# 示例策略钩子:
# - 如果您需要按国家限制:
# if country_code not in {"US", "CA", "GB"}:
# print("路由到人工审核")
# - 如果您只接受某些品牌/类型:
# if brand != "MASTERCARD" or card_type != "CREDIT":
# print("显示替代支付方式")
else:
# 当 BIN 无效时的后备(例如,提示用户重新输入)
print("无效的 BIN;提示更正。")
节省时间的实施注意事项
- 仅需要 bin 查询参数。使用卡号的前 6 位数字;不要传输完整的 PAN,以减少您系统中的 PCI 暴露。
- 性能:BIN 查找是轻量级的,理想情况下在您的结账表单或服务器端的模糊事件上触发。在会话期间考虑按 BIN 键入的短客户端或边缘缓存,以减少重复请求。
- 后备用户体验:如果 isValid 为假,请重新提示用户输入前 6 位数字。保持错误文本中立:“请检查您卡片的前 6 位数字。”
- 规范化:根据 API 提供的值存储品牌/类型/级别值(例如,MASTERCARD、CREDIT),并在您的边界层将它们映射到任何内部枚举。
- 审计:将 isValid 标志、bin_iin、品牌、类型、级别、发行者和 iso_country_code 记录到您的支付审计日志中。避免存储完整的卡号。
现实世界的金融和支付用例
- 结账表单优化:在用户输入前 6 位数字后,检测 card_brand 并显示适当的品牌图标。如果品牌或类型不受支持,请在提交事件之前提示使用其他卡。
- 路由规则:将 MASTERCARD CREDIT GOLD 卡发送到具有最佳交换率或接受配置文件的网关。
- 合规过滤器:通过检查 iso_country_code 禁止或标记来自禁运或不支持国家的 BIN。
- 欺诈启发式:将 issuer_name_bank 和 iso_country_code 与 IP 地理位置、账单国家和设备信号结合起来。不匹配可能会提高风险评分。
- 客户支持:当支付失败时,支持代理可以快速识别 BIN 中的发行者和品牌,以指导用户在需要时拨打银行电话。
通过 MCP 从 AI 代理调用相同的 API
如果您使用兼容 MCP 的客户端(例如,可以调用工具的代码助手)自动化任务,您可以通过 MCP 端点调用 Zyla API。将您的客户端指向:
https://mcp.zylalabs.com/mcp?apikey=YOUR_API_KEY
从那里,指示代理使用 GET 方法和 bin 查询参数调用卡片检查器 API 端点。如果您的 MCP 客户端配置了 API 密钥,它将自动传递您的授权头。有关 MCP 使用的一般信息,请参见 MCP 页面。
如何在您的支付流程中集成
1)客户端预检查(可选)
当用户输入前 6 位数字时,仅使用 BIN 调用您的后端。然后,您的后端调用卡片检查器 API 并返回最小有效负载(品牌、类型、级别、国家)。这避免了将您的 Zyla API 密钥暴露给浏览器。
2)授权前的服务器端验证
在创建支付意图或授权之前,使用相同的 BIN 调用 API 以确认其有效性,并捕获发行者和国家以供您的日志和规则使用。如果 isValid 为假,请短路尝试并要求提供不同的卡。
3)日志记录和分析
在您的交易尝试中存储关键字段,以便您可以按品牌/类型/发行者/国家对拒绝、接受和退款进行细分。这有助于随着时间的推移调整路由和欺诈模型。
错误处理模式
- HTTP 层:根据您的重试策略,将非 2xx 视为临时或终止。网络超时可以快速重试;持久的 4xx/5xx 应记录到日志中,并附上关联 ID。
- 响应语义:使用 isValid 布尔值和消息进行用户友好的流程。除非您有特定原因,否则请避免解析 issuer_bank_website 进行路由——issuer_name_bank 和国家是更稳定的驱动因素。
- 弹性:在临时错误上实现短的指数退避和抖动。短暂缓存积极的 BIN 查找,以避免突然的波动影响结账。
安全和隐私注意事项
- 绝不要将完整的卡号发送到您的 BIN 检查端点。提取前 6 位数字并丢弃其余部分以进行此检查。
- 将您的 Zyla API 密钥保留在服务器端;不要将其嵌入到 Web 或移动客户端中。如果您希望获得即时的客户端用户体验,请将您的后端用作薄代理。
- 仅记录您需要的内容。BIN、品牌、类型、级别、发行者和国家通常足以进行分析和规则。
在工程约束内工作
- 延迟预算:BIN 检查速度快,可以在表单输入期间或授权前执行。如果您对延迟极为敏感,请添加一个按 BIN 键入的客户端或边缘缓存,TTL 较短。
- 幂等性:请求是读取;将其视为幂等。您可以安全地在临时故障上重试。
- 国际化:iso_country_code 是 ISO alpha-2(例如,TR)。将其映射到您的本地化层以获取显示名称或特定国家的业务规则。
参考:端点回顾
- GET https://zylalabs.com/api/2333/card-checker-api/2243/check-card
- 查询参数:bin(数字,必需)。示例:444444
- 授权头:Authorization: Bearer YOUR_API_KEY
- 您通常会使用的响应字段:isValid、message、data.bin_iin、data.card_brand、data.card_type、data.card_level、data.issuer_name_bank、data.iso_country_code
提高生产质量的生活小贴士
- 功能标志集成,以便您可以按市场或按细分推出。
- 增加可观察性:跟踪请求计数、2xx/4xx/5xx 比率和 BIN 检查的 p95 延迟。
- 在测试中创建不变性:模拟上述 JSON 以验证您对 TR 中 MASTERCARD CREDIT GOLD 的路由逻辑。
- 记录您从 API 提供的字符串(例如,“MASTERCARD”)到您的枚举的内部映射,以防止静默不匹配。
常见问题解答
调用 API 的最低要求是什么?
有效的 Zyla API 密钥和卡片的前 6 位数字(bin 参数)。添加 Authorization: Bearer YOUR_API_KEY 头。
我可以在结账时使用此功能而不存储完整的卡号吗?
可以。仅发送前 6 位数字(BIN)。在此验证步骤中,请勿发送或存储完整的 PAN。
我应该持久化哪些字段?
通常:isValid、bin_iin、card_brand、card_type、card_level、issuer_name_bank 和 iso_country_code。这些对于路由、欺诈和报告最有用。
是否有免费计划?
没有免费计划。该列表提供 7 天的试用期,以便您在承诺之前进行评估。请查看 API 页面以获取当前访问选项和定价。
我可以从 AI 编码代理调用它吗?
可以。配置您的 MCP 兼容客户端以使用 Zyla MCP 端点,然后让它发出 GET 调用到卡片检查器 API,带上 bin 参数。有关详细信息,请参见上面链接的 MCP 页面。
准备在几分钟内实现卡片检查吗?打开列表并开始您的试用:开始 7 天的卡片检查器 API 试用。在 zylalabs.com 探索更多财务集成,并在本周内交付您的验证流程。