您需要快速验证银行详细信息——ACH 的路由号码、SEPA 的 IBAN 和国际电汇的 SWIFT/BIC——在您的下一个版本发布之前。通过本指南的结束，您将拥有可以验证这些标识符并返回银行元数据的工作请求，您可以在 UI 中显示或在支付工作流程中使用。
此 API 为您的财务和支付流程解决了什么
SWIFT - IBAN - 路由银行检查器 API 提供了三个专注的验证端点：
- 路由银行检查器：验证美国路由号码并返回银行元数据（名称、城市、州、电话、最后修订日期）。
- IBAN 代码检查器：验证 IBAN 并返回国家信息和解析的组件（银行代码、分行代码、BBAN、校验和）。
- SWIFT 代码检查器：验证 SWIFT/BIC 并返回银行身份、位置和代码的详细信息。
常见用例包括结账预验证以减少失败的支付、用户输入号码后自动填写银行详细信息的入职表单、验证受益人的财务操作以及在争议期间确认银行身份的支持工具。
在 Zyla API Hub 上开始
打开此 API 的列表，订阅并获取您的密钥。Zyla API Hub 使用订阅 + 配额模型（不是按调用付费）。首次在 Hub 上使用时，您可以根据 API 当前的访问选项开始 7 天试用或 50 次请求；请查看 API 页面以获取当前的访问选项和定价。
- 转到 API 页面并单击订阅（或在可用时开始免费试用）。
- 复制您的 API 密钥。
- 使用 Authorization: Bearer YOUR_API_KEY 发送请求。
Zyla API Hub 将超过 10,000 个公共 API 集中在一个帐户和一个密钥下。您可以直接在 zylalabs.com 上探索更多类别和金融 API，并在一个地方管理所有订阅。
开始 7 天试用 SWIFT - IBAN - 路由银行检查器 API
身份验证
在授权头中发送您的密钥：
- 头：Authorization
- 值：Bearer YOUR_API_KEY
下面的示例中不需要其他身份验证参数。
端点：路由银行检查器
验证美国路由号码并检索银行元数据。
- 方法：GET
- URL：https://zylalabs.com/api/1887/swift-iban-routing-bank-checker-api/1580/routing-bank-checker
- 所需查询参数：
- number (number): 121000248
cURL 示例
curl -s -X GET "https://zylalabs.com/api/1887/swift-iban-routing-bank-checker-api/1580/routing-bank-checker?number=121000248" \
-H "Authorization: Bearer YOUR_API_KEY"官方示例响应
{
"status": 200,
"success": true,
"message": "路由银行 031101334 是有效的",
"data": {
"routing_number": "031101334",
"date_of_revision": "2023年1月5日",
"new_routing_number": "",
"bank": "Sofi Bank, National Association",
"address": "旧金山，加州",
"city": "旧金山",
"state": "加州",
"zip": "",
"phone": "855-936-2269"
}
}在您的应用中使用：
- status, success, message：快速检查验证状态和用户可见的副本。
- data.routing_number：已验证的路由号码（如适用，可能反映更新）。
- data.bank, data.city, data.state, data.phone：在入职表单或管理工具中显示元数据。
- data.date_of_revision 和 data.new_routing_number：用于对账和迁移处理。
注意：date_of_revision 是一个人类可读的日期字符串。如果您需要排序或比较，请在服务器端将其解析为您的标准日期格式。
使用 requests 的 Python 示例
import os
import requests
API_KEY = os.getenv("ZYLALABS_API_KEY", "YOUR_API_KEY")
url = "https://zylalabs.com/api/1887/swift-iban-routing-bank-checker-api/1580/routing-bank-checker"
params = {"number": "121000248"}
headers = {"Authorization": f"Bearer {API_KEY}"}
resp = requests.get(url, headers=headers, params=params, timeout=10)
resp.raise_for_status()
data = resp.json()
if data.get("success"):
bank_info = data.get("data", {})
print("已验证：", data.get("message"))
print("路由：", bank_info.get("routing_number"))
print("银行：", bank_info.get("bank"))
print("位置：", f'{bank_info.get("city")}, {bank_info.get("state")}')
print("电话：", bank_info.get("phone"))
else:
# 处理验证失败（例如，显示表单错误）
print("验证失败：", data.get("message"))端点：IBAN 代码检查器
验证 IBAN 并检索国家和结构详细信息。
- 方法：GET
- URL：https://zylalabs.com/api/1887/swift-iban-routing-bank-checker-api/1581/iban-code-checker
- 所需查询参数：
- number (string): PT50000101231234567890192
成功时，您将收到验证状态和解析字段，例如：
- iban, country, sepa_country, checksum
- bban, bank_code, branch_code, account_number
用例：
- 在提供有效 IBAN 后，自动填写下游的银行名称字段。
- SEPA 特定路由：在启用 SEPA 支付方式之前检查 sepa_country 是否等于 Yes。
- 在将支付传递给处理器之前进行客户端验证。
端点：SWIFT 代码检查器
验证 SWIFT/BIC 并检索银行身份和代码的详细信息。
- 方法：GET
- URL：https://zylalabs.com/api/1887/swift-iban-routing-bank-checker-api/1582/swift-code-checker
- 所需查询参数：
- code (string): ADTVBRDF
成功时，您将收到验证状态、身份字段和结构化详细信息，包括：
- swift_code, bank, city, branch, address, post_code, country, country_code
- breakdown.swift_code, breakdown.bank_code, breakdown.country_code, breakdown.location_code, breakdown.code_status, breakdown.branch_code
典型实现：
- 当付款人输入 SWIFT/BIC 时，立即显示银行和国家，以减少表单摩擦。
- 通过检查 country_code 是否与预期走廊对齐来保护跨境走廊。
- 审计日志：持久化详细信息字段以跟踪代码被接受或拒绝的原因。
将其整合到您的产品中
结账和支付表单
- 客户端检查：当字段失去焦点时（去抖动），命中相关端点，并将消息作为内联反馈显示。
- 服务器端重新检查：在持久化或启动支付之前执行相同的调用以避免篡改。
- 成功时，存储标准化标识符（routing_number, iban, swift_code）和银行元数据以供显示和审查。
财务和财务操作
- 在夜间批量验证受益人列表；记录消息和数据字段以对账更新（例如，new_routing_number）。
- 保护跨境走廊：使用 IBAN 国家和 SWIFT country_code 启用特定轨道。
支持工具
- 构建一个“验证银行详细信息”面板，获取并显示银行、城市、州/国家和联系字段以快速确认。
操作说明和集成提示
- 幂等性：GET 请求可以安全缓存。缓存常用受益人的正验证（及相关银行元数据）。
- 日期：date_of_revision 是一个人类可读的字符串；根据需要解析以进行存储或比较。
- 国际与国内：将美国 ACH 路由到路由银行检查器；对 IBAN 区域使用 IBAN 代码检查器；在收集 BIC 的地方使用 SWIFT 代码检查器。
- 错误处理：在消费数据之前检查成功和状态。始终向用户显示清晰、可操作的消息。
- 吞吐量和配额：使用是订阅 + 配额。请查看 API 页面以获取当前的访问选项和定价。
通过 AI 代理使用 MCP 调用 API
如果您使用与 MCP 兼容的工具（例如 Claude Code、Cursor、Windsurf）编排财务工作流程，您可以通过 Zyla 的 MCP 端点调用此 API。配置您的代理以访问：
使用您的 Zyla API 密钥（apikey 查询参数），并让代理通过其市场路径调用 SWIFT - IBAN - 路由银行检查器 API 端点。这使得自主工具能够在多步骤任务中验证路由号码、IBAN 或 SWIFT 代码（例如，解析 CSV 然后验证每个受益人）。
测试清单
- 路由：使用 number=121000248 进行测试，并验证您解析消息、成功和数据字段。
- IBAN：使用 number=PT50000101231234567890192 进行测试，并确认 sepa_country 和解析组件得到处理。
- SWIFT：使用 code=ADTVBRDF 进行测试，并确保您可以显示银行、国家和详细信息字段。
- 超时和重试：设置合理的客户端超时，仅在瞬态网络错误时重试。
- 日志记录：存储消息和一部分数据字段以供审计跟踪和支持诊断。
在 Zyla API Hub 上探索更多
在 zylalabs.com 上管理您所有的财务验证和更多内容，使用一个密钥。当您需要扩展到验证之外时，浏览其他金融与支付列表并将其集成到相同的构建过程中。
常见问题
路由、IBAN 和 SWIFT 代码之间有什么区别？
路由号码用于美国国内转账（ACH/电汇）。IBAN 在许多国家（包括 SEPA）中使用，并编码国家、银行、分行和账户信息。SWIFT/BIC 在国际上识别银行，并用于跨境支付。
我如何验证请求？
在每次调用上述市场端点 URL 的请求头中发送 Authorization: Bearer YOUR_API_KEY。
我可以从无服务器函数中使用这个吗？
可以。这些是标准的 HTTPS GET 请求，带有身份验证头。将您的 API 密钥保存在平台的秘密管理器中，并设置适当的超时。
响应字段稳定吗？
使用示例中演示的字段（例如，status、success、message、data.*）。如果您需要依赖其他字段，请在发布到生产之前查看 API 页面以获取任何更新。
访问选项和限制是什么？
该 Hub 使用订阅 + 配额模型。首次访问通常提供 7 天试用或 50 次请求；请查看 API 页面以获取当前的访问选项和定价。
准备好验证银行详细信息并自信地发布了吗？在这里开始您的集成：开始 7 天试用 SWIFT - IBAN - 路由银行检查器 API
