moov/ach

moov-io/ach

Moov的使命是为开发者提供一种简单的方式，将银行处理功能创建并集成到自己的软件产品中。我们的开源项目专注于解决***服务中的单一职责，并围绕性能、可扩展性和易用性进行设计。

ACH实现了自动清算所（ACH）文件的读取器、写入器和验证器。ACH是美国电子资金转账的主要方式。HTTP服务器可通过Docker镜像获取，Go包github.com/moov-io/ach也已发布。

如果您需要ACH发起（文件创建）、OFAC检查、小额存款、SFTP上传等完整功能的实现，https://github.com/moov-io/paygate项目旨在提供ACH转账的完整系统。此外，您可查看我们的文章《如何以及何时使用Moov ACH库》。

项目状态

Moov ACH已在多个生产环境中积极使用。如果您关注其进展，请为项目点赞。该项目支持生成和解析所有标准条目分类（SEC）代码。如果您有简化任务的上层功能、业务操作或发现错误，欢迎提交issue或pull request。

使用方法

ACH项目实现了一个HTTP服务器和Go库，用于创建和修改ACH文件。目前有https://pkg.go.dev/github.com/moov-io/ach和https://github.com/moov-io/ach-node-sdk客户端库可用。我们还提供了大量https://pkg.go.dev/github.com/moov-io/ach/examples，展示读取器和写入器在各种ACH交易类型中的应用。

Docker

我们从Docker Hub发布公共Docker镜像moov/ach，也可使用此仓库。无需配置即可在:8080端口提供服务，并在:9090/metrics端口以Prometheus格式提供指标。我们还为OpenShift提供Docker镜像，发布为quay.io/moov/ach。

拉取并启动Docker镜像：

bash
docker pull docker.xuanyuan.run/moov/ach:latest
docker run -p 8080:8080 -p 9090:9090 docker.xuanyuan.run/moov/ach:latest

列出内存中存储的文件：

bash
curl localhost:8080/files

json
{"files":[],"error":null}

在HTTP服务器上创建文件：

bash
curl -X POST --data-binary "@./test/testdata/ppd-debit.ach" http://localhost:8080/files/create

json
{"id":"<您的唯一文件ID>","error":null}

读取ACH文件（JSON格式）：

bash
curl http://localhost:8080/files/<您的唯一文件ID>

json
{"file":{"id":"<您的唯一文件ID>","fileHeader":{"id":"","immediateDestination":"231380104","immediateOrigin":"121042882", ...

Google Cloud Run按钮

要在托管环境中快速开始，您可以将此项目部署到Google Cloud Platform。

从https://console.cloud.google.com/home/dashboard创建新项目，命名为：

moov-ach-demo

点击下方按钮将项目部署到Google Cloud：

在云shell中，您将被提示：

Choose a project to deploy this application:

使用箭头键选择：

moov-ach-demo

然后选择离您最近的地区，部署成功后将获得API的URL：

https://您的-ACH-应用-URL.a.run.app

在云shell中进入ach文件夹：

bash
cd ach

列出内存中存储的文件：

bash
curl https://您的-ACH-应用-URL.a.run.app/files

响应：

json
{"files":[],"error":null}

在服务器上创建文件：

bash
curl -X POST --data-binary "@./test/testdata/ppd-debit.ach" https://您的-ACH-应用-URL.a.run.app/files/create

响应：

json
{"id":"<您的唯一文件ID>","error":null}

读取已创建的文件：

bash
curl https://您的-ACH-应用-URL.a.run.app/files/<您的唯一文件ID>

响应：

json
{"file":{"id":"<您的唯一文件ID>","fileHeader":{"id":"...","immediateDestination":"231380104","immediateOrigin":"121042882", ...

配置设置

数据持久性

ACH不持久化（保存）任何关于创建的文件、批次或条目详情的数据。唯一的存储是在进程内存中，重启后ACH将没有任何文件、批次或保存的数据。此外，不对数据进行内存加密。

了解ACH

• 官方Nacha ACH开发者指南
• https://moov-io.github.io/ach/intro/
• https://moov-io.github.io/ach/create-file/
• https://moov-io.github.io/ach/file-structure/
• https://moov-io.github.io/ach/balanced-offset/
• https://moov-io.github.io/ach/merging-files/

常见问题

是否有浏览器工具可将ACH文件转换为JSON？

有！您可以在[***]找到我们的浏览器工具。

我的数据是否被保存到某处？

不，我们不保存任何与文件、批次或条目详情相关的数据。所有处理均在内存中进行。

支持哪些ACH交易类型？

我们支持生成和解析所有标准条目分类（SEC）代码。

哪里可以找到官方Nacha操作规则？

您可以直接从Nacha的网上商店购买最新的《Nacha操作规则和指南》资源。此外，Nacha还发布了免费的ACH开发者指南。

获取帮助

支持和测试的平台

• 64位Linux（Ubuntu、Debian）、macOS和Windows
• 树莓派

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

贡献

欢迎贡献！请查看我们的贡献指南和行为准则。您可以从https://github.com/moov-io/ach/contribute中选择任务。

该项目使用https://github.com/golang/go/wiki/Modules，需Go v1.14或更高版本。有关Go安装说明，请参见https://golang.org/doc/install。您可以下载源代码，我们也提供https://github.com/moov-io/ach/releases/latest，强烈建议生产环境使用标记版本。

发布

要发布ach版本，只需提交包含CHANGELOG.md和version.go更新的pull request，其中包含下一个版本号和详情。还需将标签（如git push origin v1.0.0）推送到origin，以便CI进行发布。

测试

我们维护全面的单元测试套件，建议在特定函数需要多个类似测试用例时使用表驱动测试。要运行当前目录中的所有测试文件，使用go test。当前总体覆盖率可在https://app.codecov.io/gh/moov-io/ach/上查看。

模糊测试

我们目前通过moov/achfuzz Docker镜像对ACH进行模糊测试。您可以https://github.com/moov-io/ach/blob/master/test/fuzz-reader/README.md或运行该镜像，并向`security@moov.io`报告崩溃示例。谢谢！

相关项目

作为Moov提供开源***科技基础设施计划的一部分，我们有许多活跃项目可能对您有用：

• https://github.com/moov-io/watchman：提供对美国和欧盟多个贸易制裁清单的搜索功能。

• https://github.com/moov-io/fed：实现美国联邦储备系统搜索的实用服务，如ABA路由号码、***机构名称查找以及FedACH和Fedwire路由信息。

• https://github.com/moov-io/wire：实现美联储电汇资金服务文件的写入接口，这是由美国联邦储备银行运营的实时全额结算资金转账系统。

• https://github.com/moov-io/imagecashletter：实现图像现金票据（ICL）文件，用于美国的Check21、X.9或支票截断文件交换和远程存款。

• https://github.com/moov-io/metro2：提供轻松读取、创建和验证Metro 2格式的方法，该格式用于美国信用局的消费者信用历史报告。

许可证

Apache License 2.0 - 详见LICENSE。