Pular para o conteúdo principal
Implementar o Midaz em um ambiente bancário requer uma abordagem estratégica para hierarquia de entidades e estruturação de contas. Abaixo estão as boas práticas para otimizar a configuração de organizações, ledgers, contas, Portfólios e segmentos visando eficiência operacional e escalabilidade.

​
Hierarquia ideal de Organizações e Ledgers

​
Organização única vs. múltiplas Organizações

Bancos que operam como uma única entidade legal normalmente precisam de uma Organização no Midaz. No entanto, para grupos bancários com subsidiárias, uma estrutura hierárquica é recomendada, com uma organização pai supervisionando múltiplas organizações filhas. Essa configuração se alinha com a governança corporativa e permite a segregação de dados por entidade.
A estrutura da organização deve refletir sua estrutura corporativa.

​
Usando múltiplos Ledgers

Dentro de uma organização, determine o número de ledgers a usar com base nas necessidades operacionais. Uma abordagem comum é manter um ledger principal para transações de clientes enquanto utiliza ledgers adicionais para propósitos especializados, como operações de tesouraria ou segmentação regulatória.
Use múltiplos ledgers somente quando necessário para minimizar a complexidade. Transferências entre ledgers requerem orquestração de fluxo externo via APIs.

​
Estruturação eficiente de contas para bancos de varejo e corporativos

​
Clientes de varejo – Portfolio por cliente

Para bancos de varejo, a boa prática é criar um Portfolio para cada cliente, contendo contas individuais para diferentes tipos de assets (ex.: conta corrente, poupança, cartão de crédito). Essa configuração permite recuperação eficiente de saldos e operações simplificadas.
Use o CRM para gerenciar dados pessoais como CPF/CNPJ, endereços e aliases bancários — tudo em um só lugar.

​
Clientes corporativos – contas hierárquicas

Para bancos corporativos, utilize contas filhas dentro de Portfólios para refletir a estruturação interna. Uma empresa pode ter uma conta pai para seus fundos principais e contas filhas para subdivisões como folha de pagamento ou controle de despesas.

​
Contas internas

Estabeleça contas internas para receitas, despesas e fluxos de liquidação. Contas dedicadas para “Receita de Taxas – USD” ou “Despesas com Juros – USD” garantem relatórios financeiros claros.

​
Exemplo prático: um banco digital típico

Veja como um banco digital que oferece conta corrente, poupança e transferências Pix pode estruturar seu deployment do Midaz: 
Organization: "Neobank S.A."
│
├── Ledger: "Ledger Principal (BRL)"
│   │
│   ├── Segments
│   │   ├── "Standard" (nível padrão)
│   │   ├── "VIP" (clientes premium)
│   │   └── "Business" (contas corporativas)
│   │
│   ├── Account Types
│   │   ├── "checking" → transações do dia a dia
│   │   ├── "savings" → depósitos com rendimento
│   │   ├── "settlement" → compensação interna
│   │   └── "fee-revenue" → arrecadação de taxas do banco
│   │
│   ├── Contas Internas
│   │   ├── Conta de Liquidação (compensação para Pix, TED)
│   │   ├── Conta de Receita de Taxas
│   │   └── Conta de Despesas com Juros
│   │
│   └── Portfólios de Clientes
│       ├── Portfolio: "Maria Silva"
│       │   ├── Conta Corrente (BRL) — Segment: VIP
│       │   └── Conta Poupança (BRL) — Segment: VIP
│       │
│       └── Portfolio: "Tech Corp Ltda."
│           ├── Conta Corrente Principal (BRL) — Segment: Business
│           ├── Conta de Folha de Pagamento (BRL) — Segment: Business
│           └── Conta de Despesas (BRL) — Segment: Business
│
└── Ledger: "Tesouraria"
    └── Posições de câmbio e interbancárias

​
Como uma transferência Pix flui por essa estrutura

1

Transação iniciada

Maria envia R$ 500 via Pix da sua conta corrente.
2

Rota de Operação valida

A Rota de Transação “Pix Out” é acionada — ela define um débito na conta corrente da Maria e um crédito na Conta de Liquidação, além de uma operação opcional de taxa.
3

Operações executadas

Quatro operações são criadas atomicamente: débito de R500daMaria,creˊditodeR 500 da Maria, crédito de R 500 na Liquidação, débito de R$ 0,50 de taxa da Maria e crédito na Receita de Taxas.
4

Evento publicado

O Midaz emite um evento de transação. O serviço de notificações do banco captura o evento e envia uma notificação push para a Maria.
5

Liquidação externa

A Conta de Liquidação é reconciliada com a infraestrutura Pix do Banco Central via integração externa.

​
Guia de decisão: quando dividir ledgers

CenárioRecomendação
Moeda única, unidade de negócio únicaUm ledger é suficiente
Múltiplas moedas com câmbio ocasionalUm ledger, contas de ativos separadas por moeda
Entidades legais ou subsidiárias separadasUm ledger por entidade, em organizações separadas
Requisito regulatório de isolamento de dadosLedgers separados com partições de banco de dados dedicadas
Operações de tesouraria e tradingLedger de tesouraria dedicado junto com o ledger operacional
Na dúvida, comece com um único ledger. Você sempre pode dividir depois conforme a complexidade operacional cresce. Dividir cedo demais adiciona sobrecarga de orquestração sem benefício claro.