Skip to main content
Midaz es un central de código fuente disponible (). Las instituciones financieras lo usan para construir, operar y escalar sus transacciones sobre una base modular. Mantienes el control total de tu stack. El servicio Ledger de Midaz tiene dos dominios principales: Onboarding y Transacción. También integra CRM para titulares e instrumentos, y Fees. Juntos, proporcionan los componentes para configurar, ejecutar y gobernar flujos financieros.
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 validateAccountType activado, el type de 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.
El Dominio de Onboarding configura cómo se estructura tu mundo financiero, asegurando la coherencia antes de que ocurra cualquier transacción.

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.
El Dominio de Transacción garantiza que cada movimiento se procese con precisión, transparencia y en conformidad con las reglas de negocio y contables configuradas previamente.

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.