Esta arquitectura orientada a dominios (domain-driven) garantiza que la configuración (Onboarding) y la ejecución (Transacción) permanezcan claramente separadas, pero totalmente integradas — lo que permite rendimiento, trazabilidad y agilidad de negocio.
Dominios y APIs
Dominio de Onboarding
En el Dominio de Onboarding, las instituciones estructuran sus operaciones financieras. Configuran las entidades esenciales de su ledger. Este dominio define las reglas, cuentas y relaciones que rigen cómo el ledger registra e interpreta las transacciones.Componentes del dominio de Onboarding
- Organizaciones: Una entidad comercial que opera en Midaz — como un banco, fintech o subsidiaria. Cada organización posee sus propios ledgers, configuraciones y controles de acceso. Así, una sola plataforma admite operaciones multientidad.
- Ledgers: El libro financiero central de una organización. Los rastrean cada saldo, transacción y operación. Protegen la integridad de todos los datos financieros. Piensa en un ledger como la fuente única de verdad para las finanzas de una unidad de negocio.
- : Las unidades de valor que el ledger rastrea — como BRL, USD, BTC o puntos de fidelidad. Con esta flexibilidad, las instituciones gestionan monedas tradicionales, activos digitales y programas de recompensas personalizados en el mismo sistema.
-
: Clasificaciones que definen la naturaleza y el propósito de las cuentas — por ejemplo, corriente, ahorro, custodia o liquidación. Con
validateAccountTypeactivado, eltypede una Cuenta nueva no externa debe coincidir con un valor registrado. Las Rutas de Operación validan las Cuentas por separado durante el procesamiento de la ruta. - Cuentas: Las unidades fundamentales de almacenamiento de valor — donde el dinero, o cualquier activo, realmente reside. Cada cuenta siempre se vincula a un activo. Puedes agrupar cuentas en segmentos o portafolios para reflejar tu estructura de negocio.
- : Un grupo de cuentas que pertenecen al mismo cliente, unidad de negocio o propósito. Por ejemplo, un cliente puede tener cuentas corrientes, de ahorro y de inversión en diferentes monedas. Un portafolio las une para una vista unificada.
- : Grupos de cuentas que comparten características, como niveles de cliente o divisiones regionales — por ejemplo, VIP o Estudiante. Los segmentos te ayudan a aplicar reglas, precios o beneficios diferentes en toda tu base de clientes.
Dominio de Transacción
Después de configurar el Dominio de Onboarding, el Dominio de Transacción toma el control. Impulsa la ejecución, el movimiento y la conciliación de fondos en tiempo real.Componentes del dominio de Transacción
- Saldos: El saldo actual de cualquier cuenta, incluidos sus montos disponibles y en espera (on-hold). Esta instantánea en tiempo real respalda validaciones, comprobaciones previas a la transacción y visualizaciones orientadas al cliente.
- : Plantillas reutilizables que definen las reglas para cada tramo (leg) de una transacción financiera. Una ruta especifica qué cuentas participan, en qué dirección (origen o destino) y bajo qué anotación contable. Así, cada tipo de transacción sigue reglas de negocio consistentes.
- : La unidad atómica de movimiento en el ledger — un único débito o crédito. El ledger descompone cada movimiento financiero en operaciones. Esto ofrece un completo y trazabilidad precisa para cumplimiento y reportes.
-
: Planos de transacción completos que combinan múltiples Rutas de Operación. Por ejemplo, una ruta de Transferencia Pix define todos los débitos y créditos involucrados. Cuando habilitas la validación de Rutas Contables, aplica el cumplimiento de para ese tipo de transacción. La API la expone como el recurso
transactionRoute. - Transacciones: El movimiento real de valor entre cuentas. Una transacción puede involucrar múltiples Operaciones, como comisiones, impuestos o divisiones. Esto admite flujos financieros complejos, como pagos de marketplace o liquidaciones multiparte, en un solo evento atómico.
En resumen
Midaz es una plataforma de ledger orientada a dominios para la fiabilidad, la flexibilidad y la gobernanza.
Con esta arquitectura, las instituciones financieras estructuran sus datos con precisión y operan a escala. Mantienes el control total y la transparencia sobre tu ecosistema financiero.

