8021a5fdb0
* chore(deps): backport go-libs migrator index name fix
Pulls in formancehq/go-libs#596 (backport to release/v3.6, tagged as
v3.6.2) which fixes a hardcoded `idx_version_id` name collision between
migrators sharing a schema. The bug crashes services with
`SQLSTATE 42P10` at startup. Affected DBs self-heal on next deploy -
no manual SQL required.
Co-Authored-By: Claude Opus 4.7 (1M context) <[email protected]>
* fix(ci): pin kin-openapi validator to v0.135.0
Backport of the pin already on main (commit 665ca471 / PR #697 EN-979).
v0.136.0+ rejects schemas where `$ref` has sibling fields like
`nullable`, which fails validate-openapi on V3CreatePaymentServiceUserRequest.
Constraint: cannot wrap $ref in allOf -- Speakeasy renames inlined types and breaks the published Go SDK
Rejected: rewrite schema to OAS-strict allOf | breaks SDK consumers
Confidence: high
Scope-risk: narrow
Co-Authored-By: Claude Opus 4.7 (1M context) <[email protected]>
---------
Co-authored-by: Claude Opus 4.7 (1M context) <[email protected]>
Co-authored-by: fabrice guery <[email protected]>
Formance Payments 
Getting started
Payments works as a standalone binary, the latest of which can be downloaded from the releases page.
You can move the binary to any executable path, such as to /usr/local/bin. Installing it locally using Docker is also
possible, and probably easier for testing purposes as it comes prepackaged with all the dependencies.
Note that you need to set up the STACK_PUBLIC_URL env variable to set up a publicly available URL so that webhooks
and redirects from the Payment Service Providers (PSP) can be sent to the application.
You can use NGrok for that, for example. If you don't plan on using any connectors with webhooks,
you could simply set it as localhost (or anything, really).
$ git clone [email protected]:formancehq/payments.git
$ cd payments
$ just compile-plugins
$ STACK_PUBLIC_URL=http://localhost docker compose up
Debugging
You can also use the docker-compose.dev.yml file to run the application with Delve and Air, which allow debugging and live reloading.
Use console as a frontend
The payment application comes with a console frontend when deploying through docker-compose (with or without debugging). You can access it at http://localhost:3000/formance/localhost?region=localhost.
What is it?
Basically, a framework.
A framework to ingest payin and payout coming from different payment providers (PSP).
The framework contains connectors. Each connector is basically a translator for a PSP. Translator, because the main role of a connector is to translate specific PSP payin/payout formats to a generalized format used at Formance.
Because it is a framework, it is extensible. Please follow the guide below if you want to add your connector.
Contribute
Please see the following documents:
- Connector development tutorial: CONTRIBUTING.md
- General development guidelines: CONTRIBUTING_GUIDE.md