使用路由号码银行查询API

您需要验证美国银行路由号码，并提取银行的法定名称、地址、电话、ACH能力和状态，以便您可以及时进行支付或KYC流程。在本指南结束时，您将能够在Zyla API Hub上查询路由号码银行查询API，解析结果，并将其集成到您的财务工作流程中。

此API的功能及使用时机

路由号码银行查询API返回给定美国路由号码的权威详细信息。它可以验证路由号码是否正确，并提供金融机构的名称、分支类型（例如，主办公室）、地址、电话号码、活动状态和最后更新时间。典型的用例包括：

• 在ACH入职表单上预先验证路由号码，以减少支付失败。
• 丰富会计、支付或财务系统中的银行记录。
• 在发起借记或贷记之前验证ACH资格。
• 为支持团队构建后台工具，以快速解决退回的支付。

此API属于Zyla API Hub上的财务与支付，提供一个账户、一个API密钥和一个统一的订阅模型，涵盖超过10,000个公共API。

在Zyla API Hub上开始

要调用端点，请访问Zyla API Hub上的API列表，点击订阅或开始试用，并获取您的API密钥。身份验证通过在头部添加Authorization: Bearer YOUR_API_KEY进行。

• 计费为订阅+配额（不是按调用计费）。第一个API提供7天试用或50次请求。没有免费计划。
• 有关当前访问选项和定价，请查看市场上的API页面。

从这里开始：开始7天试用路由号码银行查询API

您将使用的端点

以下是市场上列出的可用端点。仅支持显式定义的参数——请勿添加额外的键或请求体。

1) 获取银行信息

方法：GET

URL：https://zylalabs.com/api/331/routing-number-bank-lookup-api/266/get-bank-information

描述：获取有关路由号码的详细信息。该端点返回金融机构的名称、ACH路由号码、分支类型、地址、联系信息、活动状态和最后更新时间。

所需查询参数：

• routingnumber（数字）：例如，121000245
• paymentType（字符串）：例如，ach

复制粘贴cURL：

curl -s -X GET "https://zylalabs.com/api/331/routing-number-bank-lookup-api/266/get-bank-information?routingnumber=121000245&paymentType=ach" \
-H "Authorization: Bearer YOUR_API_KEY"

官方示例响应：

{
"status": "success",
"data": {
"routingNumber": "121000245",
"paymentType": "ach",
"name": "Wells Fargo Bank, Na",
"addressFull": "255 2nd Ave South, Minneapolis, MN 55479",
"street": "255 2nd Ave South",
"city": "Minneapolis",
"state": "MN",
"zip": "55479",
"type": "Main Office",
"phone": "800-245-2426",
"active": true,
"lastUpdated": "2026-07-29"
}
}

您通常会使用的关键字段：

• data.routingNumber：查询的路由号码，字符串形式。
• data.paymentType：对于此查询，“ach”标识支付轨道上下文。
• data.name，data.addressFull，data.phone：用于显示、验证和支持工作流程。
• data.type：分支类型，例如“主办公室”。
• data.active：指示路由记录是否处于活动状态。
• data.lastUpdated：用于缓存失效和审计的日期字符串。

2) 银行数据

方法：GET

URL：https://zylalabs.com/api/331/routing-number-bank-lookup-api/1353/bank-data

描述：通过查找其路由号码来检索任何银行的详细信息。它还验证提供的路由号码是否正确，并返回银行的名称、地址和联系信息等基本详细信息。

所需查询参数：

• number（数字）：例如，304082876

复制粘贴cURL：

官方示例响应：

您通常会使用的关键字段：

• status，success，message：快速验证和用户体验消息。
• data.routing_number：查询的号码，已验证。
• data.bank，data.address，data.city，data.state，data.zip，data.phone：联系和地理空间丰富。
• data.date_of_revision：用于对账和审计时间线。

Python示例（适合生产）

下面的代码片段查询获取银行信息并安全解析响应。它使用市场列表所需的确切URL和参数。

import os
import requests
from datetime import datetime

API_KEY = os.getenv("ZYLALABS_API_KEY", "YOUR_API_KEY")
URL = "https://zylalabs.com/api/331/routing-number-bank-lookup-api/266/get-bank-information"
params = {
"routingnumber": "121000245",
"paymentType": "ach"
}
headers = {
"Authorization": f"Bearer {API_KEY}"
}

resp = requests.get(URL, params=params, headers=headers, timeout=15)
resp.raise_for_status()
payload = resp.json()

if payload.get("status") != "success":
raise RuntimeError(f"查找失败：{payload}")

bank = payload.get("data", {})
name = bank.get("name")
routing = bank.get("routingNumber")
ach_type = bank.get("paymentType")
active = bank.get("active")
updated = bank.get("lastUpdated") # 例如，"2026-07-29"

# 可选：解析日期以进行缓存控制或SLA日志记录
updated_dt = None
if updated:
try:
updated_dt = datetime.strptime(updated, "%Y-%m-%d")
except ValueError:
pass

print({
"routingNumber": routing,
"name": name,
"paymentType": ach_type,
"active": active,
"address": bank.get("addressFull"),
"city": bank.get("city"),
"state": bank.get("state"),
"zip": bank.get("zip"),
"phone": bank.get("phone"),
"type": bank.get("type"),
"lastUpdated": updated
})

节省时间的实施注意事项

• 身份验证：始终发送Authorization: Bearer YOUR_API_KEY。
• 传输：两个端点都是HTTP GET，带有查询参数；请勿包含请求体。
• 缓存：使用data.lastUpdated（获取银行信息）或data.date_of_revision（银行数据）来决定何时刷新缓存。考虑对稳定的路由号码使用24-48小时的TTL，除非您的风险态度需要更严格的时效性。
• 验证用户体验：对于银行数据，在您的表单反馈中显示消息字段（例如，“路由银行304082876是有效的”）。仅在成功为真时继续进行支付发起。
• 规范化：地址以完整字符串和组件（街道、城市、州、邮政编码）返回。优先使用组件以确保PDF和电子邮件中的格式一致。
• 错误处理：在信任数据字段之前，检查HTTP状态代码和JSON中的顶级状态/成功指示器。
• 日志记录：记录routingNumber/routing_number、name/bank和lastUpdated/date_of_revision以及您的用户/会话以进行审计跟踪。

端到端示例

用例：ACH入职表单

1. 在路由号码输入框失去焦点时，调用银行数据，number设置为9位路由号码。
2. 如果成功为真，则显示data.bank、city/state和phone作为用户的确认。
3. 可选地，使用相同的路由号码和paymentType=ach调用获取银行信息，以确认活动状态和分支类型，然后启用“链接账户”按钮。
4. 将结果按路由号码缓存以避免重复查找。

用例：支付轨道完整性检查

1. 在发起ACH信用之前，调用获取银行信息，paymentType=ach。
2. 确保active为真。如果为假或缺失，则暂停支付并将案例转交支持。
3. 记录lastUpdated以进行合规性和对账报告。

用例：后台银行丰富

1. 批量处理您的路由号码，并迭代调用银行数据以丰富银行、地址和电话。
2. 在可用的情况下，添加获取银行信息以包括分支类型和addressFull供代理使用。
3. 将规范化字段导出到您的客户服务工具中，以便代理在争议期间可以按城市/州搜索。

通过MCP从AI代理调用

您可以通过AI编码代理或MCP兼容客户端使用Zyla的MCP端点进行相同的查找。将您的MCP客户端指向：

MCP

使用apikey查询参数（YOUR_API_KEY）设置您的API密钥。从那里，指示代理执行HTTP GET到上面显示的确切Hub URL，包括所需的查询参数和Authorization头。代理将接收相同的JSON结构，因此您可以在代理工作流程中链接工具调用（例如，验证路由号码，然后呈现格式化的确认）。

端点回顾和字段映射

• 获取银行信息（GET）
  • URL：https://zylalabs.com/api/331/routing-number-bank-lookup-api/266/get-bank-information
  • 参数：routingnumber（数字），paymentType（字符串）
  • 返回：routingNumber、paymentType、name、addressFull、street、city、state、zip、type、phone、active、lastUpdated
• 银行数据（GET）
  • URL：https://zylalabs.com/api/331/routing-number-bank-lookup-api/1353/bank-data
  • 参数：number（数字）
  • 返回：status、success、message、data.routing_number、data.date_of_revision、data.new_routing_number、data.bank、data.address、data.city、data.state、data.zip、data.phone

操作指导

• 安全性：将YOUR_API_KEY存储在您的服务器端环境中，而不是在客户端代码中。
• 重试：对于瞬态5xx响应，应用指数退避。不要重试验证失败（成功为假或状态指示无效号码）；请修复输入。
• 可观察性：记录请求参数和返回的状态/成功，以便排查用户输入的路由号码。
• 国际化：这些端点设计用于美国路由号码。避免将其应用于非美国账户标识符。
• 变更管理：使用lastUpdated和date_of_revision信号提醒您的团队或触发重新验证流程，如果数据发生了重大变化。

快速参考cURLs

获取银行信息（ACH）：

银行数据（验证路由）：

接下来去哪里

在Zyla API Hub上探索此API及其他财务与支付API。创建您的账户，订阅，并在多个服务中使用一个API密钥以加速您的集成。当您准备好进行实时测试时，从这里开始：开始7天试用路由号码银行查询API。您还可以随时从Zyla API Hub目录浏览更多API。

常见问题

这些端点有请求体吗？
没有。两个端点都是GET，仅带查询参数。请勿发送JSON体。

我如何进行身份验证？
在请求头中添加Authorization: Bearer YOUR_API_KEY。

我可以使用这些端点检查非ACH轨道吗？
获取银行信息在调用提供的示例路径时需要paymentType=ach。如果您需要其他轨道，请查看API页面以获取可用选项。

我应该缓存什么？
按路由号码缓存响应。使用lastUpdated（获取银行信息）或date_of_revision（银行数据）来决定何时刷新。

有免费计划吗？
没有免费计划。第一个API提供7天试用或50次请求。有关当前访问选项，请查看API列表。