Eventos de Midaz

Consulta los eventos de dominio que emiten el ledger, Fees y el CRM de Midaz, e integra tus consumidores externos para reaccionar en tiempo real.

Midaz emite eventos de dominio como mensajes CloudEvents 1.0 en modo de contenido binario sobre Kafka, publicados mediante lib-streaming. Cada evento viaja en el envoltorio compartido: ce-type nombra el evento como studio.lerian.<resource>.<event>, ce-subject lleva el id del agregado, ce-tenantid el tenant propietario (ausente en el ámbito de un solo tenant) y ce-schemaversion la versión del payload — 1.0.0 para todos los eventos de abajo.

ce-source se configura en el despliegue mediante la variable de entorno STREAMING_CLOUDEVENTS_SOURCE y no tiene valor predeterminado: cuando el streaming está habilitado, el ledger no arranca si está sin definir. Los tópicos no derivan de la fuente — Midaz enruta cada evento a un tópico explícito que pliega el segmento del servicio propietario en el primer token (lerian.streaming.ledger_<resource>.<event> para el núcleo del ledger; las capacidades CRM y Fees de abajo usan crm_ y fee_) y normaliza los guiones a guiones bajos en la cola del tópico. El ce-type conserva sus guiones (por ejemplo, balance.config-changed llega al tópico lerian.streaming.ledger_balance.config_changed pero conserva el ce-type studio.lerian.balance.config-changed). Los importes monetarios — saldos, importes de transacciones y operaciones — viajan por el hilo como cadenas decimales, nunca como floats.

​

Eventos del ledger

Hechos que el ledger emite a medida que cambian organizaciones, cuentas, saldos y transacciones.

​

Organización

Evento (ce-type)	Tópico	Se dispara cuando	Payload principal
studio.lerian.organization.created	lerian.streaming.ledger_organization.created	Se crea una organización.	id, legalName, doingBusinessAs, legalDocument, address, status, createdAt
studio.lerian.organization.updated	lerian.streaming.ledger_organization.updated	Cambian los campos mutables de una organización.	id, parentOrganizationId, legalName, doingBusinessAs, address, status, updatedAt
studio.lerian.organization.deleted	lerian.streaming.ledger_organization.deleted	Se elimina una organización.	id, deletedAt

​

Ledger

Evento (ce-type)	Tópico	Se dispara cuando	Payload principal
studio.lerian.ledger.created	lerian.streaming.ledger_ledger.created	Se crea un ledger dentro de una organización.	id, organizationId, name, status, createdAt
studio.lerian.ledger.updated	lerian.streaming.ledger_ledger.updated	Cambia el nombre o el estado de un ledger.	id, organizationId, name, status, updatedAt
studio.lerian.ledger.deleted	lerian.streaming.ledger_ledger.deleted	Se elimina un ledger.	id, organizationId, deletedAt

​

Cuenta

Evento (ce-type)	Tópico	Se dispara cuando	Payload principal
studio.lerian.account.created	lerian.streaming.ledger_account.created	Se abre una cuenta en un ledger.	id, organizationId, ledgerId, name, assetCode, type, alias, portfolioId, segmentId, status, createdAt
studio.lerian.account.updated	lerian.streaming.ledger_account.updated	Cambian los campos mutables de una cuenta.	id, organizationId, ledgerId, name, segmentId, entityId, status, blocked, updatedAt
studio.lerian.account.deleted	lerian.streaming.ledger_account.deleted	Se elimina una cuenta.	id, organizationId, ledgerId, portfolioId, deletedAt

​

Activo

Evento (ce-type)	Tópico	Se dispara cuando	Payload principal
studio.lerian.asset.created	lerian.streaming.ledger_asset.created	Se registra un activo en un ledger.	id, organizationId, ledgerId, name, type, code, status, createdAt
studio.lerian.asset.updated	lerian.streaming.ledger_asset.updated	Cambian los campos mutables de un activo.	id, organizationId, ledgerId, name, type, code, status, updatedAt
studio.lerian.asset.deleted	lerian.streaming.ledger_asset.deleted	Se elimina un activo.	id, organizationId, ledgerId, deletedAt

​

Portafolio

Evento (ce-type)	Tópico	Se dispara cuando	Payload principal
studio.lerian.portfolio.created	lerian.streaming.ledger_portfolio.created	Se crea un portafolio.	id, organizationId, ledgerId, name, entityId, status, createdAt
studio.lerian.portfolio.updated	lerian.streaming.ledger_portfolio.updated	Cambian los campos mutables de un portafolio.	id, organizationId, ledgerId, name, entityId, status, updatedAt
studio.lerian.portfolio.deleted	lerian.streaming.ledger_portfolio.deleted	Se elimina un portafolio.	id, organizationId, ledgerId, deletedAt

​

Segmento

Evento (ce-type)	Tópico	Se dispara cuando	Payload principal
studio.lerian.segment.created	lerian.streaming.ledger_segment.created	Se crea un segmento.	id, organizationId, ledgerId, name, status, createdAt
studio.lerian.segment.updated	lerian.streaming.ledger_segment.updated	Cambian los campos mutables de un segmento.	id, organizationId, ledgerId, name, status, updatedAt
studio.lerian.segment.deleted	lerian.streaming.ledger_segment.deleted	Se elimina un segmento.	id, organizationId, ledgerId, deletedAt

​

Ruta de operación

Evento (ce-type)	Tópico	Se dispara cuando	Payload principal
studio.lerian.operation-route.created	lerian.streaming.ledger_operation_route.created	Se crea una ruta de operación.	id, organizationId, ledgerId, title, code, operationType, account, accountingEntries, createdAt
studio.lerian.operation-route.updated	lerian.streaming.ledger_operation_route.updated	Cambian los campos mutables de una ruta de operación.	id, organizationId, ledgerId, title, code, operationType, account, accountingEntries, updatedAt
studio.lerian.operation-route.deleted	lerian.streaming.ledger_operation_route.deleted	Se elimina una ruta de operación.	id, organizationId, ledgerId, deletedAt

​

Ruta de transacción

Evento (ce-type)	Tópico	Se dispara cuando	Payload principal
studio.lerian.transaction-route.created	lerian.streaming.ledger_transaction_route.created	Se crea una ruta de transacción.	id, organizationId, ledgerId, title, operationRouteIds, createdAt
studio.lerian.transaction-route.updated	lerian.streaming.ledger_transaction_route.updated	Cambian los campos mutables de una ruta de transacción.	id, organizationId, ledgerId, title, operationRouteIds, updatedAt
studio.lerian.transaction-route.deleted	lerian.streaming.ledger_transaction_route.deleted	Se elimina una ruta de transacción.	id, organizationId, ledgerId, deletedAt

​

Saldo

Evento (ce-type)	Tópico	Se dispara cuando	Payload principal
studio.lerian.balance.created	lerian.streaming.ledger_balance.created	Se crea un saldo durante la configuración de la cuenta.	id, organizationId, ledgerId, accountId, alias, key, assetCode, accountType, available, onHold, allowSending, allowReceiving, createdAt
studio.lerian.balance.changed	lerian.streaming.ledger_balance.changed	Una transacción confirmada mueve un saldo — un evento por cada operación que afecta al saldo; los valores reflejan el estado posterior a la operación.	organizationId, ledgerId, accountId, balanceId, assetCode, available, onHold, version, reason, direction, amount, transactionId, operationId, occurredAt
studio.lerian.balance.config-changed	lerian.streaming.ledger_balance.config_changed	Cambian los ajustes de un saldo, o se habilita el sobregiro (se materializa el saldo acompañante). changeType distingue settings_updated de overdraft_enabled.	id, organizationId, ledgerId, accountId, allowSending, allowReceiving, direction, settings, changeType, updatedAt
studio.lerian.balance.deleted	lerian.streaming.ledger_balance.deleted	Se elimina un saldo.	id, organizationId, ledgerId, accountId, deletedAt
studio.lerian.balance.overdraft-drawn	lerian.streaming.ledger_balance.overdraft_drawn	Un débito consume sobregiro más allá de los fondos disponibles (action = drawn).	balanceId, accountId, organizationId, ledgerId, assetCode, transactionId, operationId, action, amount, overdraftBalance, overdraftLimit, occurredAt
studio.lerian.balance.overdraft-repaid	lerian.streaming.ledger_balance.overdraft_repaid	El uso del sobregiro disminuye pero no se salda por completo (action = repaid).	balanceId, accountId, organizationId, ledgerId, assetCode, transactionId, operationId, action, amount, overdraftBalance, overdraftLimit, occurredAt
studio.lerian.balance.overdraft-cleared	lerian.streaming.ledger_balance.overdraft_cleared	El sobregiro se salda por completo — señal terminal (action = cleared).	balanceId, accountId, organizationId, ledgerId, assetCode, transactionId, operationId, action, amount, overdraftBalance, overdraftLimit, occurredAt

​

Transacción

Los cuatro eventos del ciclo de vida comparten un mismo esquema de payload; los campos opcionales se rellenan según el flujo — route y routeId cuando la transacción fue enrutada, parentTransactionId solo en reverted.

Evento (ce-type)	Tópico	Se dispara cuando	Payload principal
studio.lerian.transaction.posted	lerian.streaming.ledger_transaction.posted	Una transacción recién creada se confirma en el almacenamiento con todas sus operaciones persistidas (sin padre).	id, organizationId, ledgerId, status, amount, assetCode, source, destination, route, operations, metadata, createdAt
studio.lerian.transaction.committed	lerian.streaming.ledger_transaction.committed	Una transacción pendiente pasa de PENDING a APPROVED.	id, organizationId, ledgerId, status, amount, assetCode, source, destination, operations, metadata
studio.lerian.transaction.canceled	lerian.streaming.ledger_transaction.canceled	Una transacción pendiente pasa de PENDING a CANCELED.	id, organizationId, ledgerId, status, amount, assetCode, source, destination, operations, metadata
studio.lerian.transaction.reverted	lerian.streaming.ledger_transaction.reverted	Un flujo de reversión crea una transacción hija; parentTransactionId la correlaciona con la original.	id, parentTransactionId, organizationId, ledgerId, status, amount, assetCode, source, destination, operations, metadata

​

Eventos de Fees

La capacidad Fees de Midaz gestiona los paquetes de tarifas y de facturación y registra cuándo se aplican tarifas a una transacción. Sus eventos los emite el servicio consolidado del ledger, así que comparten el ce-source del ledger — pero conservan su propio segmento de tópico y llegan bajo lerian.streaming.fee_*. Los recursos de Fees llevan el prefijo de dominio fee- en sus claves y ce-types; el plegado del tópico elimina ese prefijo antes de añadir el segmento de servicio fee_, así que fee-packages llega a fee_packages — nunca fee_fee_packages — a diferencia de CRM, cuyos nombres de recurso no llevan prefijo de dominio.

Evento (ce-type)	Tópico	Se dispara cuando	Payload principal
studio.lerian.fee-packages.created	lerian.streaming.fee_packages.created	Se crea un paquete de tarifas.	id, organizationId, ledgerId, segmentId, transactionRoute, enable, createdAt, updatedAt
studio.lerian.fee-packages.updated	lerian.streaming.fee_packages.updated	Cambian los campos mutables de un paquete de tarifas.	id, organizationId, ledgerId, segmentId, transactionRoute, enable, createdAt, updatedAt
studio.lerian.fee-packages.deleted	lerian.streaming.fee_packages.deleted	Se elimina un paquete de tarifas.	id, organizationId, ledgerId, deletedAt
studio.lerian.fee-billing-packages.created	lerian.streaming.fee_billing_packages.created	Se crea un paquete de facturación.	id, organizationId, ledgerId, type, pricingModel, countMode, enable, createdAt, updatedAt
studio.lerian.fee-billing-packages.updated	lerian.streaming.fee_billing_packages.updated	Cambian los campos mutables de un paquete de facturación.	id, organizationId, ledgerId, type, pricingModel, countMode, enable, createdAt, updatedAt
studio.lerian.fee-billing-packages.deleted	lerian.streaming.fee_billing_packages.deleted	Se elimina un paquete de facturación.	id, organizationId, ledgerId, deletedAt
studio.lerian.fee-charge.applied	lerian.streaming.fee_charge.applied	Se aplica un paquete de tarifas a una transacción confirmada.	transactionId, organizationId, ledgerId, feePackageId, appliedAt

​

Eventos del CRM

La capacidad CRM de Midaz gestiona los titulares de cuentas y sus instrumentos. Sus eventos los emite el servicio consolidado del ledger: comparten el ce-source del ledger pero conservan su propio segmento de tópico, llegando bajo lerian.streaming.crm_*, y siguen el mismo envoltorio y versionado que cualquier otro evento de Midaz.

​

Titular

Evento (ce-type)	Tópico	Se dispara cuando	Payload principal
studio.lerian.holder.created	lerian.streaming.crm_holder.created	Se crea un titular.	id, organizationId, type, externalId, createdAt
studio.lerian.holder.updated	lerian.streaming.crm_holder.updated	Cambian los campos mutables de un titular.	id, organizationId, type, externalId, updatedAt
studio.lerian.holder.deleted	lerian.streaming.crm_holder.deleted	Se elimina un titular.	id, organizationId, deletionType, deletedAt

​

Instrumento

Un instrumento es una entidad regulada, así que el documento, los datos bancarios y los campos regulatorios son PII y nunca cruzan por el hilo — solo identificadores estables, el ámbito org/holder/ledger/account, la clasificación de tipo y una lista reducida de partes relacionadas (cada entrada lleva solo relatedPartyId y un role sin PII).

Evento (ce-type)	Tópico	Se dispara cuando	Payload principal
studio.lerian.instrument.created	lerian.streaming.crm_instrument.created	Se crea un instrumento para un titular y una cuenta.	id, holderId, organizationId, ledgerId, accountId, type, relatedParties, createdAt
studio.lerian.instrument.updated	lerian.streaming.crm_instrument.updated	Cambian los campos mutables de un instrumento.	id, holderId, organizationId, ledgerId, accountId, type, relatedParties, updatedAt
studio.lerian.instrument.deleted	lerian.streaming.crm_instrument.deleted	Se elimina un instrumento.	id, holderId, organizationId, deletionType, deletedAt
studio.lerian.instrument.related-party-deleted	lerian.streaming.crm_instrument.related_party_deleted	Se elimina una única parte relacionada de un instrumento (ce-subject es el id del instrumento).	instrumentId, holderId, organizationId, relatedPartyId, deletedAt