Publicador de eventos

Publica eventos de transacciones en RabbitMQ en tiempo real para que sistemas externos reaccionen sin acoplarse fuertemente a Midaz.

​

Por qué es importante

---

Los eventos publicados permiten que tus sistemas reaccionen a una transacción en el momento en que ocurre. Puedes activar notificaciones a clientes, sincronizar tu ERP, alimentar tableros de análisis o iniciar flujos de trabajo de cumplimiento. Tus sistemas se mantienen poco acoplados.

Las secciones a continuación cubren la configuración técnica. Para una visión general del negocio, consulta Sobre Midaz.

​

Habilitar eventos de transacción

---

Midaz publica eventos de transacción por defecto. Trata la variable como habilitada salvo que la definas en false. La configuración de ejemplo incluida define la variable en false. En un stack que se inicia desde ese ejemplo, define la variable en true en la aplicación de transacciones:

JSON

RABBITMQ_TRANSACTION_EVENTS_ENABLED=true

Con la variable habilitada, Midaz publica eventos en este intercambio de RabbitMQ:

JSON

transaction.transaction_events.exchange

​

Tipos de eventos

---

Midaz emite uno de estos tipos de evento, según la etapa del ciclo de vida de la transacción:

Acción	Descripción
APPROVED	La transacción se completó exitosamente. Esto incluye transacciones de un solo paso y transacciones de dos fases que se han confirmado.
PENDING	Se creó una transacción de dos fases y está esperando confirmación o cancelación.
CANCELED	Una transacción de dos fases fue cancelada antes de la confirmación.
CREATED	Se inició una transacción de reversión. Este es un estado transitorio que progresa a APPROVED una vez completado el procesamiento.
NOTED	Se registró una transacción de anotación. La transacción queda registrada en el libro contable sin afectar los saldos de las cuentas.

​

Ejemplo de carga útil del evento

---

JSON

{
  "source": "midaz",
  "eventType": "transaction",
  "action": "APPROVED",
  "timestamp": "0000-00-00T18:09:03.757330233Z",
  "version": "v3.0.0",
  "organizationId": "0198575d-f9fd-702b-bb15-fa4c980b32c7",
  "ledgerId": "0198575d-fa0b-7ac7-8b7d-9d3ab7dccafc",
  "payload": {
    "id": "0198575f-a8f9-7924-a6d7-8122f2c77ddd",
    "status": {
      "code": "APPROVED",
      "description": "APPROVED"
    },
    "amount": "1",
    "assetCode": "BRL",
    "source": ["account:1"],
    "destination": ["account:2"],
    "metadata": {
      "key": "value"
    },
    "operations": [
      {
        "type": "DEBIT",
        "amount": { "value": "1" },
        "accountAlias": "account:1"
      },
      {
        "type": "CREDIT",
        "amount": { "value": "1" },
        "accountAlias": "account:2"
      }
    ]
  }
}

La carga útil completa incluye marcas de tiempo, instantáneas de saldo y otros identificadores. Los usas para auditoría y trazabilidad.

​

Modelo de enrutamiento de eventos

---

Midaz usa un intercambio de tipo topic para publicar mensajes. No envía mensajes directamente a colas específicas. Controlas qué eventos recibes con tus propios enlaces.

​

Cómo funciona el enrutamiento

Midaz etiqueta cada evento con una routingKey. La routingKey usa este formato:

midaz.transaction.<status>

El valor <status> es el estado actual de la transacción: APPROVED, PENDING, CANCELED, CREATED o NOTED.

Para consumir eventos, tu aplicación debe:

1. Crear una cola en RabbitMQ.

2. Vincular tu cola al intercambio de Midaz con un patrón de routingKey para los eventos que quieres.

​

Resumen visual

Figura 1. Representación visual del modelo de enrutamiento de eventos.

Puedes configurar múltiples colas con diferentes enlaces para servir a equipos o servicios específicos de forma independiente.

​

Ejemplo de cola y enlace

---

​

Crear una nueva cola

JSON

{
  "queues": [
    {
      "name": "new_queue_name.queue",
      "vhost": "/",
      "durable": true
    }
  ]
}

​

Vincular la cola para recibir todos los eventos

JSON

{
  "bindings": [
    {
      "source": "transaction.transaction_events.exchange",
      "vhost": "/",
      "destination": "new_queue_name.queue",
      "destination_type": "queue",
      "routing_key": "midaz.transaction.*"
    }
  ]
}

El comodín * coincide con los cinco estados: APPROVED, PENDING, CANCELED, CREATED y NOTED. Para suscribirte a un solo tipo de evento, reemplaza el comodín por el estado exacto. Por ejemplo, midaz.transaction.NOTED recibe solo eventos de anotación.

Midaz no gestiona ni crea colas de RabbitMQ por ti. Debes aprovisionar las colas y configurar los enlaces correctos.