mirror of https://github.com/hanzo-fi/payments.git synced 2026-10-30 20:31:20 +00:00

Files

T

zeekay 7d727874d5 chore: rebrand Formance Payments -> Hanzo Payments (hanzo-fi)

- go.mod module path + all self-imports: github.com/formancehq/payments -> github.com/hanzo-fi/payments
  (1590 .go files / 3152 refs; 20 modules: root, pkg/client, pkg/domain, 18 ce/plugins).
  External dep kept: formancehq/go-libs.
- plugins: each ce/plugins/* consumed a *published* pkg/domain; added local
  'replace .../pkg/domain => ../../../pkg/domain' (consistent with root) so every
  standalone plugin module builds in-monorepo. compile-plugin.sh MOD var rebranded too.
- branding: README, LICENSE (dual MIT+EE; upstream copyright retained + Hanzo added),
  goreleaser (release images -> registry.hanzo.ai/hanzo-fi, OCI labels, homepage),
  proto go_package, renovate, speakeasy gen.yaml, connector-template *.gotpl.
- CI: removed Numary/Formance workflows + composite action; added canonical hanzo.yml +
  cicd.yml (hanzoai/ci, gated HANZO_CI_ENABLED) + secretless ci.yml (go build/vet).
- kept as data/compat keys: wire capability enums ALLOW_FORMANCE_*, generated SDK type
  client.Formance, domain field FormanceRedirectURL, OTEL_SERVICE_NAME, upstream base image.
- verified: go build ./... (default + -tags ee) + all 20 nested modules green.

2026-07-05 13:08:55 -07:00

2.2 KiB

Raw Permalink Blame History

Hanzo Payments

Hanzo Payments is the payments connectivity engine of Hanzo Finance. It is a framework for ingesting pay-ins and pay-outs from many different Payment Service Providers (PSPs) and normalizing them into a single, generalized format.

The framework is built around connectors. Each connector is a translator for a PSP: its main role is to translate a specific PSP's pay-in/pay-out formats into the generalized model used across Hanzo. Because it is a framework, it is extensible — follow the contributor guide below to add your own connector.

Getting started

Payments runs as a standalone binary. Installing it locally with Docker is easiest for testing, as the compose stack comes prepackaged with all dependencies.

Set the STACK_PUBLIC_URL env variable to a publicly available URL so webhooks and redirects from PSPs can reach the application. You can use a tunnel such as ngrok for this. If you do not plan to use connectors with webhooks, you may set it to localhost.

git clone [email protected]:hanzo-fi/payments.git
cd payments
just compile-plugins
STACK_PUBLIC_URL=https://subdomain.ngrok-free.app docker compose up

Debugging

Use docker-compose.dev.yml to run the application with Delve and Air for debugging and live reload.

Storage

Hanzo Payments defaults to Hanzo Base (embedded SQLite), per-tenant — each org/project gets its own isolated store with no external database to run. PostgreSQL remains a first-class, opt-in option for shared/multi-instance scale (STORAGE_DRIVER=postgres).

Modules

Community Edition connectors live under ce/plugins/ (MIT-licensed).
Enterprise Edition connectors live under ee/plugins/ (see ee/LICENSE); build with -tags ee.

Contribute

Connector development tutorial: CONTRIBUTING.md
General development guidelines: CONTRIBUTING_GUIDE.md

Attribution

Hanzo Payments is a fork of Formance Payments. See LICENSE — Community Edition is MIT, Enterprise Edition (ee/) is under ee/LICENSE. Upstream copyright remains with Formance Solutions; Hanzo modifications © Hanzo AI, Inc.

2.2 KiB Raw Permalink Blame History