Lo que obtienes
Midaz
El ledger. Contiene organizaciones, ledgers, cuentas y transacciones con garantías de partida doble. El CRM y el Fees Engine se ejecutan dentro del mismo proceso.
Tracer
Validación en tiempo real delante del ledger. Devuelve permitir, denegar o marcar para revisión antes de que tu aplicación envíe la transacción.
Reporter
Informes repetibles a partir de plantillas de texto plano sobre las tablas del ledger. Genera archivos HTML, CSV, XML, PDF y TXT.
Access Manager
Una sola capa de control de acceso. Responde quién hace una solicitud y a qué puede acceder ese llamador.
Console
La interfaz web del stack. Los operadores configuran los productos y hacen el trabajo diario en un solo lugar.
Streaming Hub
El borde de entrega para eventos. Envía hechos del ledger y de Tracer a un webhook, una cola o un cursor que consultas tú.
Cómo encajan las piezas
- Tu aplicación envía el contexto completo de la transacción a Tracer. Tracer evalúa tus reglas y límites de gasto, y luego devuelve permitir, denegar o marcar para revisión.
- Si permite, tu aplicación envía la transacción a Midaz. Tracer nunca llama al ledger.
- Cuando aplica un paquete de comisiones, Midaz agrega los cálculos de comisiones a la transacción que envías. Tu aplicación puede llamar primero a los endpoints de comisiones para estimarlas.
- Midaz registra las operaciones balanceadas. Con streaming habilitado, publica el hecho en
lerian.streaming.ledgerjusto después del cambio de estado. - Streaming Hub compara ese hecho con tus suscripciones y lo entrega a tu webhook, cola o cursor de pull.
- Reporter lee las tablas del ledger que registraste como fuente de datos, y genera los archivos que pide tu regulador.
TRACER_BASE_URL y un tracer.mode por ledger de advisory o enforce. La ruta de transacción de Ledger HTTP v2 entonces reserva capacidad de límite con Tracer antes de confirmar. Ledger HTTP v1 nunca hace esta llamada. En esta ruta, Midaz llama a Tracer, y Tracer sigue sin llamar nunca a Midaz.
Qué posee cada pieza
Adóptalo pieza por pieza
1
Levanta Midaz
Midaz es la base del ledger, así que va primero. El CRM y el Fees Engine se ejecutan dentro del proceso del ledger, así que no despliegas ningún servicio adicional para ellos.
2
Agrega Access Manager
Access Manager emite los tokens en los que confía cada servicio. Agrégalo justo después de Midaz, antes de cualquier producto o interfaz.
3
Coloca Tracer delante
Tu aplicación llama a Tracer antes de enviar, y solo envía a Midaz si Tracer permite. Tracer nunca inicia una llamada a Midaz ni lee saldos.
4
Registra las bases de datos del ledger en Reporter
Agrega cada base de datos de Midaz como fuente de datos de PostgreSQL con credenciales de solo lectura. Apunta Reporter a una réplica de lectura donde tengas una, para que las consultas de informes no afecten la ruta de escritura del ledger.
5
Habilita los módulos y activa los eventos
Habilita los productos que ejecutas desde la página de configuración de Console. Activa el streaming en Midaz cuando necesites los hechos fuera de la plataforma, porque la publicación está desactivada de forma predeterminada.
Trae lo tuyo
- Tu nube. Ejecuta la plataforma en Lerian Cloud, o trae tu propia nube y despliega tú mismo los Helm charts oficiales.
- Tus consumidores de eventos. Streaming Hub entrega a cinco tipos de destino: webhook, pull, SQS, RabbitMQ y EventBridge.
- Tus otras bases de datos. Un solo despliegue de Reporter genera informes sobre Midaz, sobre tus propias bases de datos, y sobre ambos en la misma plantilla.
- Tu stack de aplicación. Midaz expone una API REST, y Lerian publica SDKs para Go y TypeScript.
- Tu conciliación. Agrega Matcher cuando compares el ledger contra bancos y proveedores de pago. Consulta la solución de conciliación.
Un ejemplo práctico
Un cash-out de Pix mueve BRL de una cuenta de cliente hacia una cuenta externa.
- La cuenta de cliente
customer_12345_brlya existe. Midaz creó por ti la cuenta de liquidación@external/BRL, junto con el activoBRL. - Tu aplicación envía el monto, las cuentas y el contexto a Tracer. Tracer devuelve permitir.
- Tu aplicación envía 100.00 BRL contra la ruta de transacción
PIX_CASH_OUT. - Midaz registra dos operaciones balanceadas, un débito en la cuenta del cliente y un crédito en
@external/BRL. Ambas llevan el mismotransactionId. - Midaz publica
transaction.postedenlerian.streaming.ledger. - Streaming Hub entrega ese hecho a tu webhook, firmado con un HMAC sobre la marca de tiempo y el cuerpo exacto de la solicitud.
- Al cierre del día, Reporter genera tu archivo de conciliación a partir de las tablas del ledger.
Empieza aquí
Primeros pasos
Evalúa la plataforma, elige un modelo de despliegue y ejecuta tu primera transacción de partida doble.
Construir un core banking completo
El diagrama completo del stack, y los pasos de conexión que ejecutas tú mismo.
Lerian Cloud y BYOC
Quién opera la infraestructura en cada modelo, y qué se queda de tu lado.
Instalar Midaz
Ejecuta el entorno completo del ledger localmente con Docker Compose.
Guía de integración de Tracer
Dónde se ubica la llamada de validación en tu flujo, y cómo manejar cada decisión.
Inicio rápido de Reporter
Sube una plantilla, genera tu primer informe y verifica el archivo descargado.

