Esta arquitectura orientada a dominios mantiene la configuración (Onboarding) y la ejecución (Transaction) separadas pero integradas.
Dominios y API
Dominio Onboarding
En el Dominio Onboarding, las instituciones estructuran sus operaciones financieras. Configuran las entidades esenciales de su ledger. Este dominio define las reglas, las cuentas y las relaciones que gobiernan cómo el ledger registra e interpreta las transacciones.Componentes del Dominio Onboarding
- Organizaciones: una entidad de negocio que opera sobre Midaz, como un banco, una fintech o una subsidiaria. Cada organización tiene sus propios ledgers, configuraciones y controles de acceso. Una plataforma admite entonces operaciones multi-entidad.
- 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 única fuente 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 administran 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, de ahorro, escrow o de liquidación. Con
validateAccountTypehabilitado, eltypede una nueva cuenta no externa debe coincidir con un valor registrado. Las rutas de operación validan las cuentas por separado durante el procesamiento de rutas. - Cuentas: las unidades fundamentales de almacenamiento de valor, donde vive el dinero o cualquier activo. Cada cuenta siempre se vincula a un activo. Puedes agrupar las cuentas en segmentos o portafolios para reflejar la estructura de tu 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 distintas monedas. Un portafolio las une para dar 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 distintos en toda tu base de clientes.
Dominio Transaction
Después de que configuras el Dominio Onboarding, el Dominio Transaction toma el control. Impulsa la ejecución, el movimiento y la conciliación de fondos en tiempo real.Componentes del Dominio Transaction
- Saldos: el saldo actual de cualquier cuenta, incluidos sus montos disponibles y retenidos. Esta instantánea en tiempo real sustenta validaciones, verificaciones previas a la transacción y pantallas para el cliente.
- : plantillas reutilizables que definen las reglas de cada tramo 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 solo débito o crédito. El ledger descompone cada movimiento financiero en operaciones. Esto da un completo y trazabilidad precisa para cumplimiento e informes.
-
: planos completos de transacción que combinan varias rutas de operación. Por ejemplo, una ruta de transferencia Pix define sus reglas de origen y destino. Cuando habilitas la validación de rutas contables, Midaz valida la ruta de transacción y sus rutas de operación para ese tipo de transacción. La API expone esto como el recurso
transactionRoute. - Transacciones: el movimiento real de valor entre cuentas. Una transacción puede involucrar varias Operaciones, como comisiones, impuestos o divisiones. Esto admite flujos financieros complejos, como pagos de marketplace o liquidaciones entre varias partes, en un solo evento atómico.
Referencia de dominios
Midaz es una plataforma de ledger orientada a dominios.

