Afecta a
Equipos que se integran con Midaz y necesitan reaccionar a los eventos del ledger — conciliación, notificaciones, proyecciones downstream y analítica — en lugar de hacer polling de la API REST. Esto incluye tanto los despliegues self-hosted que tienen su propio broker como los integradores externos / SaaS que consumen eventos a través de un edge gestionado. Este es un cambio de nueva documentación. Describe capacidades de entrega de eventos existentes; no se introduce ningún comportamiento nuevo de producto.
Qué cambió
Ya está disponible una nueva guía de referencia, Recibir eventos de Midaz. Cubre las dos formas admitidas de consumir el stream de eventos de Midaz y cómo elegir entre ellas.
RabbitMQ directo
Vincula tu propia cola directamente a los topic exchanges AMQP (0-9-1) de Midaz. Es la mejor opción para despliegues self-hosted o co-localizados donde operas el broker de Midaz. La guía documenta los exchanges relevantes y los flags de entorno self-hosted que los habilitan.Streaming Hub
Suscríbete a través del servicio gestionado de fan-out de Lerian con una API REST de control-plane, con entrega por Webhook, Pull (HTTP), SQS, RabbitMQ o EventBridge. Es la mejor opción para integradores externos / SaaS que quieren bajo acoplamiento y suscripciones por tenant sin operar un broker.Cómo elegir
Midaz publica cada evento de dominio en ambos transportes en paralelo, por lo que las dos superficies exponen los mismos eventos subyacentes. La guía incluye una comparación lado a lado (transporte, a qué te conectas, acoplamiento y escenarios de mejor ajuste) para ayudarte a elegir el enfoque correcto.Impacto
Este es un cambio informativo. No cambian los endpoints, los esquemas de eventos ni el comportamiento de entrega. No hay nada que migrar y no se requiere ninguna acción. Clasificación: Informativo. El cambio es la disponibilidad de una referencia consolidada para recibir eventos de Midaz.
Qué debes hacer
1
Lee Recibir eventos de Midaz para entender los dos enfoques de un vistazo.
2
Si ejecutas tu propio broker de Midaz, revisa la sección de RabbitMQ directo y los flags de entorno self-hosted.
3
Si te integras como consumidor externo, revisa la sección de Streaming Hub y elige tu transporte de entrega.