Skip to main content
Midaz es , un central. 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 centrales: Onboarding y Transaction. También integra CRM para titulares e instrumentos, y Fees. Juntos, entregan los componentes para configurar, ejecutar y gobernar los flujos financieros.
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 validateAccountType habilitado, el type de 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.
El Dominio Onboarding configura cómo se estructura tu mundo financiero. Da consistencia antes de que ocurra cualquier transacción.

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.
El Dominio Transaction procesa cada movimiento en cumplimiento de las reglas de negocio y contables que configuras upstream.

Referencia de dominios


Midaz es una plataforma de ledger orientada a dominios.