Esta arquitectura dirigida por dominios (domain-driven) garantiza que la configuración (Onboarding) y la ejecución (Transaction) permanezcan claramente separadas, pero totalmente integradas, lo que permite rendimiento, trazabilidad y agilidad empresarial.
Dominios y APIs
Dominio de Onboarding
El dominio de Onboarding es donde las instituciones estructuran sus operaciones financieras configurando las entidades esenciales de su Ledgers. Este dominio establece las reglas, cuentas y relaciones que rigen cómo se registrarán e interpretarán las transacciones.Componentes del dominio de Onboarding
- Organizaciones: Representa una entidad comercial — como un banco, fintech o subsidiaria — que opera dentro de Midaz. Cada organización posee sus propios Ledgers, configuraciones y controles de acceso, lo que permite operaciones multi-entidad bajo una sola plataforma.
- : El libro financiero central de una organización. Los Ledgers rastrean cada saldo, transacción y operación, asegurando la integridad en todos los datos financieros. Piensa en un ledger como la fuente única de verdad para las finanzas de una unidad de negocio.
- : Definen las unidades de valor rastreadas en el Ledger — como BRL, USD, BTC o puntos de fidelidad. Esta flexibilidad permite a las instituciones gestionar monedas tradicionales, activos digitales y programas de recompensas personalizados dentro del mismo sistema.
- : Clasificaciones que definen la naturaleza y el propósito de las cuentas (p. ej., corriente, ahorro, custodia, liquidación). Estos tipos permiten el enrutamiento adecuado de las transacciones y aseguran que las reglas de negocio se apliquen de forma consistente en todas las categorías de cuentas.
- Cuentas: Las unidades fundamentales de almacenamiento de valor — donde el dinero (o cualquier activo) realmente reside. Las cuentas siempre están vinculadas a un activo y se pueden organizar aún más en segmentos o portafolios para reflejar tu estructura de negocio.
- : Agrupan múltiples cuentas que pertenecen al mismo cliente, unidad de negocio o propósito. Por ejemplo, un solo cliente puede tener cuentas corrientes, de ahorro y de inversión en diferentes monedas — un portafolio las une para una vista unificada.
- : Permiten la agrupación de cuentas bajo características compartidas, como niveles de cliente (p. ej., VIP, Estudiante) o divisiones regionales. Los segmentos ayudan a aplicar reglas diferenciadas, precios o beneficios en toda tu base de clientes.
Dominio de Transacción
Una vez que se configura el dominio de Onboarding, el dominio de Transacción toma el control, impulsando la ejecución en tiempo real, el movimiento y la conciliación de fondos.Componentes del dominio de Transacción
- Saldos: Recupera el saldo actual de cualquier cuenta, incluyendo sus montos disponibles, en espera (on-hold) y reservados. Esta es la instantánea financiera en tiempo real que 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 — especificando qué cuentas participan, en qué dirección (origen/destino) y bajo qué anotación contable. Aseguran que cada tipo de transacción siga reglas de negocio consistentes.
- : La unidad atómica de movimiento en el Ledger — un único débito o crédito. Todos los movimientos financieros se descomponen en operaciones, proporcionando un completo y trazabilidad precisa para cumplimiento y reportes.
- : Plantillas de transacción completas compuestas por múltiples Rutas de Operación. Por ejemplo, una ruta de “Transferencia Pix” define todos los débitos y créditos involucrados, asegurando el cumplimiento de cada vez que se ejecuta ese tipo de transacción.
- Transacciones: El movimiento real de valor entre cuentas. Las transacciones pueden involucrar múltiples Operaciones (p. ej., comisiones, impuestos, divisiones), permitiendo flujos financieros complejos como pagos de marketplace o liquidaciones multi-parte en un solo evento atómico.
En resumen
Midaz es una plataforma de Ledger dirigida por dominios, diseñada para la fiabilidad, la flexibilidad y la gobernanza.
| Dominio | Propósito | APIs Clave |
|---|---|---|
| Onboarding | Estructura y configuración del ecosistema financiero. | Organizaciones, Ledgers, Activos, Tipos de cuenta, Cuentas, Portafolios, Segmentos. |
| Transacción | Ejecución, movimiento y contabilidad de operaciones financieras. | Saldos, Rutas de transacción, Transacciones, Rutas de operación, Operaciones |