Skip to main content
This feature is part of Formance Enterprise Edition.
The Formance Platform can stream all platform events to a message broker, giving you a real-time feed of everything happening across your stack. This enables you to build reactive integrations, power audit pipelines, or feed events into your own data infrastructure.

Overview

When a broker is configured, every service in the stack publishes events to it. Events are organized into topics following the format:
{stackName}-{module}
The following services produce events:
RoleServices
ProducersLedger, Gateway, Payments
ConsumersOrchestration, Webhooks
Webhooks are built on top of the event stream — they subscribe to broker topics and forward matching events to your configured endpoints. See Webhooks for more details.

Supported brokers

The platform supports two message brokers:
BrokerRequirements
NATSVersion 2.6+ with Jetstream enabled
KafkaStandard Kafka cluster

Configuration

The broker is configured at the stack level via the broker.dsn setting.
apiVersion: formance.com/v1beta1
kind: Settings
metadata:
  name: formance-dev-broker
spec:
  key: broker.dsn
  stacks:
    - "formance-dev"
  value: nats://nats.formance-system.svc:4222?replicas=3
For detailed broker setup instructions, see Message Broker infrastructure.