Skip to main content
O Midaz oferece suporte à banca de varejo e corporativa por meio de uma hierarquia de entidades clara. Esta página traz boas práticas para estruturar organizações, ledgers, contas, portfólios e segmentos. Uma boa estrutura mantém as operações simples conforme você cresce.

Hierarquia ideal de Organizações e Ledgers


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

Um banco que opera como uma única entidade legal precisa de uma Organização no Midaz. Para um grupo bancário com subsidiárias, use uma organização pai sobre várias organizações filhas. Essa estrutura se alinha com a sua governança corporativa. Ela também isola os dados por entidade.
A estrutura da organização deve refletir sua estrutura corporativa.

Usando múltiplos Ledgers

Dentro de uma organização, escolha o número de ledgers conforme suas necessidades operacionais. Mantenha um ledger principal para as transações de clientes. Adicione ledgers para propósitos especiais, como operações de tesouraria ou segmentação regulatória.
Use múltiplos ledgers apenas quando necessário para manter a complexidade baixa. Uma transferência entre ledgers precisa de orquestração externa através da API.

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


Clientes de varejo – Portfolio por cliente

Para bancos de varejo, crie um Portfolio para cada cliente. Cada portfólio contém uma conta por tipo de ativo, como conta corrente, poupança ou cartão de crédito. Essa estrutura facilita a leitura de saldos por cliente.
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, use contas filhas dentro dos portfólios para refletir a estrutura interna. Uma empresa pode ter uma conta pai para seus fundos principais. Ela pode adicionar contas filhas para subdivisões, como folha de pagamento ou controle de despesas.

Contas internas

Crie contas internas para receitas, despesas e fluxos de liquidação. Contas com nomes como “Receita de Taxas – USD” ou “Despesas com Juros – USD” mantêm os relatórios financeiros claros.

Exemplo prático: um banco digital típico


Este exemplo mostra como um banco digital pode estruturar seu deployment do Midaz. O banco oferece conta corrente, poupança e transferências Pix.

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 Transação valida

A Rota de Transação “Pix Out” se aplica. Ela define um débito na conta corrente da Maria e um crédito na Conta de Liquidação. Ela também pode adicionar uma operação de taxa.
3

Operações executadas

O Midaz cria quatro operações de forma atômica. Ele debita R500daMariaecreditaR 500 da Maria e credita R 500 na Liquidação. Ele também debita uma taxa de R0,50daMariaecreditaR 0,50 da Maria e credita R 0,50 na Receita de Taxas.
4

Evento publicado

Quando o streaming está habilitado, STREAMING_BROKERS e o source do roster do Ledger estão configurados, e a transação alcança um estado elegível do ciclo de vida, o Midaz emite um CloudEvent do ciclo de vida da transação. O serviço de notificações do banco lê o evento e envia uma notificação push para a Maria.
5

Liquidação externa

Uma integração externa reconcilia a Conta de Liquidação com a infraestrutura Pix do Banco Central.

Guia de decisão: quando dividir ledgers

Na dúvida, comece com um único ledger. Você sempre pode dividir depois conforme a complexidade operacional cresce. Se dividir cedo demais, você adiciona sobrecarga de orquestração sem benefício claro.