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%E9%A1%B9%E7%9B%AE%E6%97%A8%E5%9C%A8%E6%8F%90%E4%BE%9BACH%E8%BD%AC%E8%B4%A6%E7%9A%84%E5%AE%8C%E6%95%B4%E7%B3%BB%E7%BB%9F%E3%80%82%E6%AD%A4%E5%A4%96%EF%BC%8C%E6%82%A8%E5%8F%AF%E6%9F%A5%E7%9C%8B%E6%88%91%E4%BB%AC%E7%9A%84%E6%96%87%E7%AB%A0%E3%80%8A%E5%A6%82%E4%BD%95%E4%BB%A5%E5%8F%8A%E4%BD%95%E6%97%B6%E4%BD%BF%E7%94%A8Moov ACH库》。

项目状态

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

使用方法

ACH项目实现了一个HTTP服务器和Go库，用于创建和修改ACH文件。目前有https://pkg.go.dev/github.com/moov-io/ach%E5%92%8Chttps://github.com/moov-io/ach-node-sdk%E5%AE%A2%E6%88%B7%E7%AB%AF%E5%BA%93%E5%8F%AF%E7%94%A8%E3%80%82%E6%88%91%E4%BB%AC%E8%BF%98%E6%8F%90%E4%BE%9B%E4%BA%86%E5%A4%A7%E9%87%8Fhttps://pkg.go.dev/github.com/moov-io/ach/examples%EF%BC%8C%E5%B1%95%E7%A4%BA%E8%AF%BB%E5%8F%96%E5%99%A8%E5%92%8C%E5%86%99%E5%85%A5%E5%99%A8%E5%9C%A8%E5%90%84%E7%A7%8DACH%E4%BA%A4%E6%98%93%E7%B1%BB%E5%9E%8B%E4%B8%AD%E7%9A%84%E5%BA%94%E7%94%A8%E3%80%82

Docker

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

拉取并启动Docker镜像：

bash
docker pull moov/ach:latest
docker run -p 8080:8080 -p 9090:9090 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。

从Google Cloud控制台创建新项目，命名为：

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%E4%B8%AD%E9%80%89%E6%8B%A9%E4%BB%BB%E5%8A%A1%E3%80%82

该项目使用https://github.com/golang/go/wiki/Modules%EF%BC%8C%E9%9C%80Go v1.14或更高版本。有关Go安装说明，请参见Golang安装指南。您可以下载源代码，我们也提供https://github.com/moov-io/ach/releases/latest%EF%BC%8C%E5%BC%BA%E7%83%88%E5%BB%BA%E8%AE%AE%E7%94%9F%E4%BA%A7%E7%8E%AF%E5%A2%83%E4%BD%BF%E7%94%A8%E6%A0%87%E8%AE%B0%E7%89%88%E6%9C%AC%E3%80%82

发布

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

测试

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

模糊测试

我们目前通过moov/achfuzz Docker镜像对ACH进行模糊测试。您可以https://github.com/moov-io/ach/blob/master/test/fuzz-reader/README.md%E6%88%96%E8%BF%90%E8%A1%8C%E8%AF%A5%E9%95%9C%E5%83%8F%EF%BC%8C%E5%B9%B6%E5%90%91%60security@moov.io%60%E6%8A%A5%E5%91%8A%E5%B4%A9%E6%BA%83%E7%A4%BA%E4%BE%8B%E3%80%82%E8%B0%A2%E8%B0%A2%EF%BC%81

相关项目

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

• https://github.com/moov-io/watchman%EF%BC%9A%E6%8F%90%E4%BE%9B%E5%AF%B9%E7%BE%8E%E5%9B%BD%E5%92%8C%E6%AC%A7%E7%9B%9F%E5%A4%9A%E4%B8%AA%E8%B4%B8%E6%98%93%E5%88%B6%E8%A3%81%E6%B8%85%E5%8D%95%E7%9A%84%E6%90%9C%E7%B4%A2%E5%8A%9F%E8%83%BD%E3%80%82

• https://github.com/moov-io/fed%EF%BC%9A%E5%AE%9E%E7%8E%B0%E7%BE%8E%E5%9B%BD%E8%81%94%E9%82%A6%E5%82%A8%E5%A4%87%E7%B3%BB%E7%BB%9F%E6%90%9C%E7%B4%A2%E7%9A%84%E5%AE%9E%E7%94%A8%E6%9C%8D%E5%8A%A1%EF%BC%8C%E5%A6%82ABA%E8%B7%AF%E7%94%B1%E5%8F%B7%E7%A0%81%E3%80%81***%E6%9C%BA%E6%9E%84%E5%90%8D%E7%A7%B0%E6%9F%A5%E6%89%BE%E4%BB%A5%E5%8F%8AFedACH%E5%92%8CFedwire%E8%B7%AF%E7%94%B1%E4%BF%A1%E6%81%AF%E3%80%82

• https://github.com/moov-io/wire%EF%BC%9A%E5%AE%9E%E7%8E%B0%E7%BE%8E%E8%81%94%E5%82%A8%E7%94%B5%E6%B1%87%E8%B5%84%E9%87%91%E6%9C%8D%E5%8A%A1%E6%96%87%E4%BB%B6%E7%9A%84%E5%86%99%E5%85%A5%E6%8E%A5%E5%8F%A3%EF%BC%8C%E8%BF%99%E6%98%AF%E7%94%B1%E7%BE%8E%E5%9B%BD%E8%81%94%E9%82%A6%E5%82%A8%E5%A4%87%E9%93%B6%E8%A1%8C%E8%BF%90%E8%90%A5%E7%9A%84%E5%AE%9E%E6%97%B6%E5%85%A8%E9%A2%9D%E7%BB%93%E7%AE%97%E8%B5%84%E9%87%91%E8%BD%AC%E8%B4%A6%E7%B3%BB%E7%BB%9F%E3%80%82

• https://github.com/moov-io/imagecashletter%EF%BC%9A%E5%AE%9E%E7%8E%B0%E5%9B%BE%E5%83%8F%E7%8E%B0%E9%87%91%E7%A5%A8%E6%8D%AE%EF%BC%88ICL%EF%BC%89%E6%96%87%E4%BB%B6%EF%BC%8C%E7%94%A8%E4%BA%8E%E7%BE%8E%E5%9B%BD%E7%9A%84Check21%E3%80%81X.9%E6%88%96%E6%94%AF%E7%A5%A8%E6%88%AA%E6%96%AD%E6%96%87%E4%BB%B6%E4%BA%A4%E6%8D%A2%E5%92%8C%E8%BF%9C%E7%A8%8B%E5%AD%98%E6%AC%BE%E3%80%82

• https://github.com/moov-io/metro2%EF%BC%9A%E6%8F%90%E4%BE%9B%E8%BD%BB%E6%9D%BE%E8%AF%BB%E5%8F%96%E3%80%81%E5%88%9B%E5%BB%BA%E5%92%8C%E9%AA%8C%E8%AF%81Metro 2格式的方法，该格式用于美国信用局的消费者信用历史报告。

许可证

Apache License 2.0 - 详见LICENSE。