Jerarquía óptima de Organizaciones y Ledgers
Una Organización o varias
Un banco que opera como una única entidad legal necesita una Organización en Midaz. Para un grupo bancario con subsidiarias, usa una organización principal sobre varias organizaciones hijas. Esta estructura corresponde a tu gobierno corporativo. También aísla los datos por entidad.La estructura de la organización debe reflejar tu estructura corporativa.
Usar varios Ledgers
Dentro de una organización, elige el número de ledgers según tus necesidades operativas. Mantén un ledger principal para las transacciones de los clientes. Agrega ledgers para propósitos especiales, como operaciones de tesorería o segmentación regulatoria.Usa varios ledgers solo cuando sea necesario para mantener baja la complejidad. Una transferencia entre ledgers necesita orquestación externa a través de la API.
Estructuración eficiente de cuentas para banca minorista y corporativa
Clientes minoristas: un Portafolio por cliente
Para la banca minorista, crea un Portafolio para cada cliente. Cada portafolio contiene una cuenta por tipo de activo, como cuenta corriente, ahorros o tarjeta de crédito. Esta estructura hace que los saldos sean fáciles de leer por cliente.Clientes corporativos: cuentas jerárquicas
Para la banca corporativa, usa cuentas hijas dentro de los portafolios para reflejar la estructura interna. Una empresa puede tener una cuenta principal para sus fondos generales. Puede agregar cuentas hijas para subdivisiones, como nómina o control de gastos.Cuentas internas
Crea cuentas internas para ingresos, gastos y flujos de liquidación. Las cuentas con nombre como “Fee Income – USD” o “Interest Expense – USD” mantienen clara la contabilidad financiera.Ejemplo práctico: un banco digital típico
Este ejemplo muestra cómo un banco digital puede estructurar su implementación de Midaz. El banco ofrece cuentas corrientes, ahorros y transferencias Pix.
Cómo fluye una transferencia Pix por esta estructura
1
Transacción iniciada
Maria envía R$ 500 vía Pix desde su cuenta corriente.
2
La Transaction Route valida
Se aplica la Transaction Route “Pix Out”. Define un débito de la cuenta corriente de Maria y un crédito a la Settlement Account. También puede agregar una operación de comisión.
3
Las operaciones se ejecutan
Midaz crea cuatro operaciones de forma atómica. Debita R 500 a Settlement. También debita una comisión de R 0.50 a Fee Revenue.
4
Evento publicado
Cuando el streaming está habilitado,
STREAMING_BROKERS y la fuente del roster del Ledger están configurados, y la transacción alcanza un estado del ciclo de vida elegible, Midaz emite un CloudEvent de ciclo de vida de transacción. El servicio de notificaciones del banco lee el evento y envía a Maria una notificación push.5
Liquidación externa
Una integración externa concilia la Settlement Account con la infraestructura Pix del banco central.

