您需要快速验证银行详细信息,以便付款不会失败,合规检查不会阻止您的发布。在本指南结束时,您将交付一个生产就绪的集成,使用 SWIFT - IBAN - 路由银行检查器 API 在 Zyla API Hub 上验证美国路由号码、IBAN 和 SWIFT/BIC 代码。
此 API 提供的内容
SWIFT - IBAN - 路由银行检查器 API 提供三个专注的验证端点:
- 路由银行检查器:验证美国路由号码并检索银行身份详细信息。
- IBAN 代码检查器:验证 IBAN 并提取其结构化组件。
- SWIFT 代码检查器:验证 SWIFT/BIC 并获取银行和位置元数据。
这些端点用于付款入职、供应商银行 KYC、支付编排、对账和客户支持工具。每个端点都以清晰的有效性消息和结构化数据响应下游逻辑(例如,在 ACH 启动之前阻止无效输入或标记不匹配的国家代码)。
在 Zyla API Hub 上开始
要开始,请打开列表并订阅。Zyla 使用订阅 + 配额(不是按调用付费)。首次使用时,您可以开始 7 天试用或 50 次请求;请查看 API 页面以获取当前访问选项和定价。您将在订阅后立即收到 API 密钥。
所有请求都使用授权头:
Authorization: Bearer YOUR_API_KEY
从这里开始: 开始 7 天试用 SWIFT - IBAN - 路由银行检查器 API
您本周可以交付的端点
1) 路由银行检查器
验证美国路由号码并检索银行的身份数据。
- 方法: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": "CA",
"zip": "",
"phone": "855-936-2269"
}
}
要使用的内容:
- data.routing_number:您应该存储的标准化路由号码。
- data.bank, data.city, data.state:在入职期间向用户呈现以确认。
- data.date_of_revision 和 data.new_routing_number:处理潜在的银行合并或更新。
- message 和 success:快速有效性检查,供您的 UI 和日志使用。
2) IBAN 代码检查器
验证 IBAN 并获取解析的组件以进行跨境转账和合规检查。
- 方法:GET
- URL:https://zylalabs.com/api/1887/swift-iban-routing-bank-checker-api/1581/iban-code-checker
- 所需查询参数:number (string) — 示例:PT50000101231234567890192
官方 curl:
官方示例响应形状(您应该期望使用的字段):
要使用的内容:
- data.iban:标准化的 IBAN 字符串。
- data.country 和 data.sepa_country:验证国家期望和 SEPA 支持。
- data.bank_code, data.branch_code, data.account_number:用于对账和表单预览。
3) SWIFT 代码检查器
验证 SWIFT/BIC 并检索银行和位置元数据,以安全地路由国际电汇。
- 方法:GET
- URL:https://zylalabs.com/api/1887/swift-iban-routing-bank-checker-api/1582/swift-code-checker
- 所需查询参数:code (string) — 示例:ADTVBRDF
官方 curl:
官方示例响应形状(您应该期望使用的字段):
要使用的内容:
- data.bank, data.city, data.country:在发起电汇之前向付款人显示。
- data.swift_code 和 data.breakdown:向用户解释格式并验证长度/分支。
可复制的 Python 示例
此 Python 代码段验证美国路由号码并打印您通常会存储或显示的核心字段。它调用路由银行检查器端点并从上述官方响应字段读取。
import requests
API_KEY = "YOUR_API_KEY"
NUMBER = "121000248" # 示例路由号码
url = "https://zylalabs.com/api/1887/swift-iban-routing-bank-checker-api/1580/routing-bank-checker"
params = {"number": NUMBER}
headers = {"Authorization": f"Bearer {API_KEY}"}
resp = requests.get(url, params=params, headers=headers, timeout=15)
resp.raise_for_status()
data = resp.json()
if data.get("success"):
info = data.get("data", {})
print("有效的路由号码")
print("路由:", info.get("routing_number"))
print("银行:", info.get("bank"))
print("地址:", info.get("address"))
print("城市/州:", f"{info.get('city')}, {info.get('state')}")
print("电话:", info.get("phone"))
else:
print("无效的路由号码或查找失败")
print("消息:", data.get("message"))
节省时间的实用实施细节
- 授权:在每个请求中发送 Authorization: Bearer YOUR_API_KEY。
- 幂等性:验证是只读的。可以安全地在超时时重试,使用指数退避。
- 缓存:按路由号码、IBAN 或 SWIFT 代码缓存结果。这些标识符变化不频繁;24 小时缓存是验证 UI 的典型做法。
- 用户反馈:将银行名称/国家/城市反馈给用户,以便他们可以发现错别字(例如,SWIFT 位置不匹配)。
- 标准化:持久化标准化字段(例如,data.routing_number、data.iban、data.swift_code),以确保跨服务的一致性。
- 日志记录:记录成功和消息以进行故障排除;在生产日志中不要记录 IBAN 的完整账户号码。
- 错误:在信任数据之前检查状态和成功;在客户端处理网络错误和超时。
您现在可以交付的财务用例
- 付款入职表单:在保存受益人数据之前验证路由号码和 IBAN;显示银行名称以确认正确性。
- 国际电汇:验证 SWIFT/BIC 和国家,以防止错误路由的转账和合规例外。
- 供应商 KYC:将 IBAN 或 SWIFT 中的国家与供应商提供的详细信息进行交叉检查,以进行风险评分。
- 对账工具:使用解析的 IBAN 组件(bank_code、branch_code、account_number)进行数据匹配和审计跟踪。
- 支持仪表板:让代理确认路由或 SWIFT 代码的银行身份,以更快地解决付款失败。
通过 MCP 从 AI 代理调用
如果您从 AI 代码助手或代理协调请求,可以通过 Zyla 的 MCP 端点路由调用。将您的 MCP 兼容客户端指向:
在初始化 MCP 传输时,将您的密钥作为查询参数提供(apikey=YOUR_API_KEY),然后让代理对上述使用的相同 Hub URL 执行标准 HTTPS GET 请求。在代理的请求中保留 Authorization: Bearer YOUR_API_KEY 头,并传递每个端点列出的确切查询参数。这使得像 Claude Code、Cursor 和 Windsurf 这样的工具能够在交互会话或自动任务中验证路由号码、IBAN 和 SWIFT 代码,而无需在提示中存储凭据。
集成检查清单
- 订阅并通过环境变量或秘密管理器保护您的 API 密钥。
- 实现您需要的三个验证调用(路由、IBAN、SWIFT)。如果您专注于美国,请从路由号码开始。
- 添加客户端和服务器端验证,以便尽早阻止格式错误的输入;依赖 API 进行权威检查。
- 按密钥缓存验证的标识符,以最小化延迟和配额使用。
- 记录 API 的消息和成功字段以进行可观察性。
- 在瞬态 HTTP/网络错误上退避并重试;在明确的无效结果上不要重试。
参考:确切的端点摘要
路由银行检查器
- 方法:GET
- URL:https://zylalabs.com/api/1887/swift-iban-routing-bank-checker-api/1580/routing-bank-checker
- 参数:number=121000248
IBAN 代码检查器
- 方法:GET
- URL:https://zylalabs.com/api/1887/swift-iban-routing-bank-checker-api/1581/iban-code-checker
- 参数:number=PT50000101231234567890192
SWIFT 代码检查器
- 方法:GET
- URL:https://zylalabs.com/api/1887/swift-iban-routing-bank-checker-api/1582/swift-code-checker
- 参数:code=ADTVBRDF
常见问题
我该如何进行身份验证?
在每个请求中发送 Authorization: Bearer YOUR_API_KEY。
是否有免费计划?
没有免费计划。Zyla 使用订阅 + 配额。首次使用时,您可以开始 7 天试用或 50 次请求;请查看 API 页面以获取当前访问选项和定价。
验证后我应该存储哪些字段?
存储标准化的标识符和关键元数据:routing_number 或 iban 或 swift_code,以及银行名称和国家。对于 IBAN,您还可以存储 bank_code、branch_code 和 account_number(如果需要进行对账)。
我可以缓存结果吗?
可以。按确切标识符(路由号码、IBAN、SWIFT)缓存,因为它们很少更改。在编辑或定期(例如,每日)时重新验证。
我可以从 CI 或代理调用这个吗?
可以。使用相同的 Hub URL 和授权头。对于 AI 代理,通过 MCP 端点路由,并将密钥保存在代理的秘密存储中。
如果您准备好防止失败的付款并加快入职,请订阅 SWIFT - IBAN - 路由银行检查器 API 并立即获取您的密钥: 开始 7 天试用 SWIFT - IBAN - 路由银行检查器 API