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
- Organizacione: Define la entidad comercial que opera dentro de Midaz. Cada organización posee sus propios Ledgers, configuraciones y controles de acceso.
- Ledgers: 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.
- Activos: Definen las unidades de valor rastreadas en el Ledger, como BRL, USD, BTC o puntos de fidelidad. Cada cuenta debe estar vinculada a un activo específico.
- 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.
- Cuentas: Las unidades fundamentales de almacenamiento de valor. Las cuentas siempre están vinculadas a un activo y se pueden organizar aún más en segmentos o portafolios.
- Portafolios: 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.
- 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.
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. Es esencial para las validaciones y comprobaciones previas a la transacción.
- 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.
- Operaciones: La unidad atómica de movimiento en el Ledger: un único débito o crédito. Todos los movimientos financieros se descomponen en operaciones para una trazabilidad precisa.
- 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.
- 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.
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 |

