> ## Documentation Index
> Fetch the complete documentation index at: https://docs.lerian.studio/llms.txt
> Use this file to discover all available pages before exploring further.

# Estruturando operações bancárias com Midaz

> Projete Organizações, Ledgers, Portfólios e Segmentos para o varejo e o corporativo — boas práticas para hierarquias escaláveis.

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.

<Note>
  A estrutura da organização deve refletir sua estrutura corporativa.
</Note>

### 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.

<Note>
  Use múltiplos ledgers somente quando necessário para minimizar a complexidade. Transferências entre ledgers requerem orquestração de fluxo externo via APIs.
</Note>

## 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.

<Tip>
  Use o [CRM](/pt/midaz/crm/crm-data-security) para gerenciar dados pessoais como CPF/CNPJ, endereços e aliases bancários — tudo em um só lugar.
</Tip>

### 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

<Steps>
  <Step title="Transação iniciada">
    Maria envia R\$ 500 via Pix da sua conta corrente.
  </Step>

  <Step title="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.
  </Step>

  <Step title="Operações executadas">
    Quatro operações são criadas atomicamente: débito de R$ 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.
  </Step>

  <Step title="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.
  </Step>

  <Step title="Liquidação externa">
    A Conta de Liquidação é reconciliada com a infraestrutura Pix do Banco Central via integração externa.
  </Step>
</Steps>

### Guia de decisão: quando dividir ledgers

| Cenário                                      | Recomendação                                                 |
| :------------------------------------------- | :----------------------------------------------------------- |
| Moeda única, unidade de negócio única        | Um ledger é suficiente                                       |
| Múltiplas moedas com câmbio ocasional        | Um ledger, contas de ativos separadas por moeda              |
| Entidades legais ou subsidiárias separadas   | Um ledger por entidade, em organizações separadas            |
| Requisito regulatório de isolamento de dados | Ledgers separados com partições de banco de dados dedicadas  |
| Operações de tesouraria e trading            | Ledger de tesouraria dedicado junto com o ledger operacional |

<Tip>
  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.
</Tip>