moov/fed

moov-io/fed

概述

Moov的使命是让开发者能够轻松地创建和集成银行处理功能到自己的软件产品中。Fed是Moov旗下的开源项目，专注于实现用于搜索美国联邦储备系统的工具服务，包括ABA路由号码查询、***机构名称查找，以及Fedwire和FedACH路由信息检索。该项目提供HTTP服务器（可通过Docker镜像获取）和Go包github.com/moov-io/fed，主要用于ACH origination（如Moov的paygate项目）。数据来源于美联储银行服务网站，支持官方纯文本和JSON格式的FedWire与FedACH数据。

项目状态

Moov Fed已在多个生产环境中积极使用。如对项目进展感兴趣，请为项目点赞。欢迎提交issue或拉取请求，感谢支持！

核心功能与特性

• ABA路由号码查询：支持通过路由号码查找对应的***机构信息
• FedACH与FedWire数据检索：提供FedACH和FedWire路由信息查询服务
• HTTP API服务：内置HTTP服务器，提供RESTful API接口
• Docker部署：可通过Docker镜像快速部署，无需复杂配置
• 多格式数据支持：兼容美联储官方纯文本和JSON数据格式
• 轻量级设计：无外部依赖，配置简单，易于集成

使用场景

• ***科技应用中的ACH origination流程
• 银行信息验证与路由信息查询
• 支付处理系统中的***机构信息检索
• 需要集成FedWire或FedACH数据的后端服务

使用方法

Docker部署

Moov提供公开Docker镜像moov/fed（Docker Hub）和quay.io/moov/fed（OpenShift）。默认在:8086端口提供HTTP服务，:9096/metrics提供Prometheus格式的指标数据。

拉取并启动Docker镜像

bash
docker pull moov/fed:latest
docker run -p 8086:8086 -p 9096:9096 moov/fed:latest

ACH路由号码查询示例

通过路由号码查询FedACH***机构信息：

bash
curl "localhost:8086/fed/ach/search?routingNumber=273976369"

响应示例：

json
{
  "achParticipants": [
    {
      "routingNumber": "273976369",
      "officeCode": "O",
      "servicingFRBNumber": "071000301",
      "recordTypeCode": "1",
      "revised": "041513",
      "newRoutingNumber": "000000000",
      "customerName": "VERIDIAN CREDIT UNION",
      "achLocation": {
        "address": "1827 ANSBOROUGH",
        "city": "WATERLOO",
        "state": "IA",
        "postalCode": "50702",
        "postalCodeExtension": "0000"
      },
      "phoneNumber": "3192878332",
      "statusCode": "1",
      "viewCode": "1"
    }
  ],
  "wireParticipants": null
}

FedWire路由号码查询示例

通过路由号码查询FedWire***机构信息：

bash
curl "localhost:8086/fed/wire/search?routingNumber=273976369"

响应示例：

json
{
  "achParticipants": null,
  "wireParticipants": [
    {
      "routingNumber": "273976369",
      "telegraphicName": "VERIDIAN",
      "customerName": "VERIDIAN CREDIT UNION",
      "wireLocation": {
        "city": "WATERLOO",
        "state": "IA"
      },
      "fundsTransferStatus": "Y",
      "fundsSettlementOnlyStatus": " ",
      "bookEntrySecuritiesTransferStatus": "N",
      "date": "20141107"
    }
  ]
}

配置设置

可通过环境变量配置Fed服务，以下是主要配置项：

数据持久化

Fed不持久化任何查询数据，所有数据仅存储在进程内存中，服务重启后无数据保留。内存中的数据未加密。

学习资源

• Fedwire简介
• FedACH简介
• 美国财政部FAQ
• https://github.com/moov-io/fed/blob/master/docs/Fed_STATE_CODES.md
• https://github.com/moov-io/fed/blob/master/docs/fpddir_FORMAT.md
• https://github.com/moov-io/fed/blob/master/docs/FEDACHDIR_FORMAT.md

获取帮助

支持的平台

• 64位Linux（Ubuntu、Debian）
• 64位macOS
• 64位Windows

注意：32位平台存在已知问题，不支持。

相关项目

• https://github.com/moov-io/watchman%EF%BC%9A%E6%8F%90%E4%BE%9B%E7%BE%8E%E5%9B%BD%E5%92%8C%E6%AC%A7%E7%9B%9F%E8%B4%B8%E6%98%93%E5%88%B6%E8%A3%81%E5%90%8D%E5%8D%95%E6%90%9C%E7%B4%A2%E5%8A%9F%E8%83%BD
• https://github.com/moov-io/imagecashletter%EF%BC%9A%E5%AE%9E%E7%8E%B0Image Cash Letter（ICL）文件处理，用于美国支票 truncation
• https://github.com/moov-io/wire%EF%BC%9A%E5%AE%9E%E7%8E%B0Fedwire Funds Service文件写入接口
• https://github.com/moov-io/ach%EF%BC%9A%E6%8F%90%E4%BE%9BACH%E6%96%87%E4%BB%B6%E7%94%9F%E6%88%90%E5%92%8C%E8%A7%A3%E6%9E%90%E5%8A%9F%E8%83%BD%EF%BC%8C%E6%94%AF%E6%8C%81%E6%89%80%E6%9C%89%E6%A0%87%E5%87%86%E6%9D%A1%E7%9B%AE%E4%BB%A3%E7%A0%81
• https://github.com/moov-io/metro2%EF%BC%9A%E6%94%AF%E6%8C%81Metro 2格式的读写和验证，用于美国消费者信用报告

版权与免责声明

版权声明

(c) 联邦储备银行

访问本仓库中的https://github.com/moov-io/fed/tree/master/data%E5%8D%B3%E8%A1%A8%E7%A4%BA%E6%82%A8%E5%90%8C%E6%84%8F%E8%81%94%E9%82%A6%E5%82%A8%E5%A4%87%E9%93%B6%E8%A1%8C%E4%BD%BF%E7%94%A8%E6%9D%A1%E6%AC%BE%E5%92%8C%E7%94%B5%E5%AD%90%E6%94%AF%E4%BB%98%E8%B7%AF%E7%94%B1%E7%9B%AE%E5%BD%95%E4%BD%BF%E7%94%A8%E6%9D%A1%E6%AC%BE%E5%8D%8F%E8%AE%AE%E3%80%82

免责声明

本仓库与联邦储备银行无关联，并非Fedwire和FedACH数据的官方来源。

开源许可

Apache License 2.0 - 详见https://raw.githubusercontent.com/moov-io/fed/master/LICENSE