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 (Incorporación)
El dominio de Onboarding es donde las instituciones estructuran sus operaciones financieras configurando las entidades esenciales de su libro mayor. 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
- Organizations (Organizaciones): Define la entidad comercial que opera dentro de Midaz. Cada organización posee sus propios libros mayores, configuraciones y controles de acceso.
- Ledgers (Libros Mayores): El libro financiero central de una organización. Los libros mayores rastrean cada saldo, transacción y operación, asegurando la integridad en todos los datos financieros.
- Assets (Activos): Definen las unidades de valor rastreadas en el libro mayor, como BRL, USD, BTC o puntos de fidelidad. Cada cuenta debe estar vinculada a un activo específico.
- Account Types (Tipos de Cuenta): Clasificaciones sistemáticas que definen la naturaleza y el propósito de las cuentas dentro de una estructura financiera. Estos tipos permiten el enrutamiento adecuado de las transacciones y la validación operativa en diferentes categorías de cuentas.
- Accounts (Cuentas): Las unidades fundamentales de almacenamiento de valor. Las cuentas siempre están vinculadas a un activo (Asset) y se pueden organizar aún más en segmentos o carteras.
- Portfolios (Carteras): Agrupaciones de cuentas relacionadas con un cliente, una unidad de negocio o un propósito específico. Ayudan a estructurar saldos en múltiples activos dentro del mismo contenedor lógico.
- Segments (Segmentos): 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 o beneficios diferenciados.
El Dominio de Onboarding configura cómo se estructura tu mundo financiero, asegurando la coherencia antes de que tenga lugar cualquier transacción.
Dominio de Transaction (Transacción)
Una vez que se configura el dominio de Onboarding, el dominio de Transaction toma el control, impulsando la ejecución en tiempo real, el movimiento y la conciliación de fondos.Componentes del dominio de Transaction
- Balances (Saldos): Recupera el saldo actual de cualquier cuenta, incluyendo sus montos disponibles, en espera (on-hold) y reservados. Es esencial para las validaciones y comprobaciones previas a la transacción.
- Operation Routes (Rutas de Operación): Componentes de transacción individuales que definen el comportamiento para cada “tramo” (leg) de una transacción financiera. Cada ruta especifica su anotación contable (título/descripción), el tipo de cuenta esperado o jugador de cuenta específico y la dirección (origen y destino), estableciendo reglas de validación para el procesamiento de transacciones.
- Operations (Operaciones): La unidad atómica de movimiento en el libro mayor: un único débito o crédito. Todos los movimientos financieros se descomponen en operaciones para una trazabilidad precisa.
- Transaction Routes (Rutas de Transacción): Plantillas de transacción completas compuestas por múltiples Rutas de Operación (Operation Routes) que juntas forman un evento financiero equilibrado. Cada Ruta de Transacción requiere al menos una Ruta de Operación de origen y una de destino, lo que garantiza la validación adecuada de doble entrada y el procesamiento estructurado de transacciones.
- Transactions (Transacciones): Agrupan movimientos de valor entre cuentas. Las transacciones pueden tener múltiples Operaciones, lo que garantiza un procesamiento flexible y de múltiples entradas.
El dominio de Transaction garantiza que cada movimiento se procese con precisión, transparencia y de acuerdo con las reglas contables y de negocio configuradas previamente.
En resumen
Midaz es una plataforma de libro mayor 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. | Organizations, Ledgers, Assets, Account Types, Accounts, Portfolios, Segments |
| Transaction | Ejecución, movimiento y contabilidad de operaciones financieras. | Balances, Transaction Routes, Transactions, Operation Routes, Operations |