O que cada componente faz
Cada componente resolve uma camada específica do problema:
Juntas, essas três partes conectam o fluxo da aplicação Pix, o cálculo de tarifas e os lançamentos no ledger. Valide o comportamento exato das tarifas e o formato dos lançamentos com o contrato do Fees Engine do seu deploy.
Escolha do seu modelo de participação no Pix
O contrato de aplicação do Pix Plugin foi projetado para os dois modelos de participação definidos pelo BACEN. A integração de tarifas e o fluxo no ledger desta página valem para os dois.
Para uma comparação detalhada, veja Modelos de participação no Pix.
Fintech lançando Pix com tarifas automatizadas
Uma fintech planeja oferecer Pix aos seus clientes. Ela quer cobrar uma tarifa fixa em cada Pix recebido (cash-in). A tarifa cobre custos operacionais e acrescenta receita sem complexidade extra para o cliente. A lógica de tarifa e a estrutura do ledger continuam as mesmas nos dois modelos. Isso vale tanto se a fintech for participante indireta (via BTG) quanto participante direta (via JD).
O objetivo de negócio
- Oferecer pagamentos Pix instantâneos aos clientes finais
- Cobrar uma tarifa transparente e configurável nas transferências recebidas
- Registrar cada tarifa no ledger para conformidade e relatórios financeiros
- Lançar rápido, sem lógica de tarifa customizada nem pipelines de conciliação
Configuração no Midaz
A fintech primeiro estrutura seu ambiente Midaz:1
Criar a organização
Registre a fintech como uma organização no Midaz. Essa é a entidade de nível mais alto, dona de todos os ledgers, contas e transações.
2
Configurar o ledger
Crie um ledger para acompanhar todas as transações de clientes e os movimentos de tarifa. O Pix Plugin e o Fees Engine compartilham esse ledger.
3
Definir o ativo
Registre BRL como o ativo de operação. Todas as transações Pix e todos os cálculos de tarifa usam esse ativo.
4
Criar as contas de clientes
Cada cliente recebe uma conta no ledger. Essas contas recebem os créditos Pix e seguem as regras de tarifa.
5
Criar as contas de destino das tarifas
Configure contas internas para receber os créditos de tarifa, por exemplo uma conta “Pix Fee Revenue”. A configuração do pacote no Fees Engine referencia essas contas.
6
Organizar com segmentos
Use segmentos para agrupar clientes por nível (por exemplo, Standard, Premium). Isso permite aplicar pacotes de tarifas diferentes a grupos diferentes.
Configuração do Fees Engine
Com a estrutura do ledger pronta, a fintech configura um pacote de tarifas:- Tipo de tarifa: tarifa fixa de R$ 1,50 por Pix recebido
- Escopo: aplicada a todas as transações de cash-in no ledger principal
- Roteamento: o Fees Engine roteia os créditos de tarifa para a conta interna “Pix Fee Revenue”
- Isenções: acrescente as contas de nível Premium à lista de contas isentas
Você configura os pacotes de tarifas uma vez, e o Fees Engine os aplica automaticamente. Quando uma transação Pix atende aos critérios do pacote (ledger, segmento, faixa de valor), o Fees Engine calcula e roteia a tarifa sem nenhum passo manual.
Como uma transação flui
Quando um cliente recebe uma transferência Pix, acontece o seguinte:1
O Pix chega
A instituição pagadora inicia um Pix. Seu provedor de conectividade (BTG no indireto, JD no direto) recebe a transação e avisa o Pix Plugin.
2
A transação é validada
O plugin valida o recebedor: confere se a conta existe, está ativa e pode receber recursos. O plugin também confere os dados de CRM e a validade da chave Pix.
3
A liquidação começa
Depois que o plugin confirma a transação, a liquidação começa. O plugin busca no Midaz os dados da conta de destino.
4
As tarifas são calculadas automaticamente
O Fees Engine avalia a transação diante dos pacotes de tarifas disponíveis. Ele encontra um pacote correspondente e calcula a tarifa fixa de R$ 1,50.
5
O ledger registra o quadro completo
O Midaz registra a transação com a distribuição da tarifa em uma única operação:
- O Midaz credita a conta do cliente com o valor líquido (bruto menos a tarifa).
- O Midaz credita a conta de destino da tarifa com R$ 1,50.
- Cada movimento é rastreável, com precisão de partidas dobradas.
6
A transação está concluída
O cliente vê o crédito Pix na conta dele. O ledger registra a tarifa para relatórios e conciliação.
O que a fintech ganha
- Sem lógica de tarifa customizada: o Fees Engine cuida do cálculo, do roteamento e das isenções.
- Ledger preciso: cada tarifa é um lançamento no ledger. Os auditores veem os mesmos números que o seu time financeiro vê.
- Segmentação de clientes: o Fees Engine isenta os clientes Premium automaticamente pela lista de contas isentas.
- Flexibilidade de tarifas: mude os valores das tarifas, acrescente tarifas percentuais ou introduza faixas por valor sem mudanças no seu pipeline de transações.
O que você precisa para começar
Para rodar essa configuração, sua instituição precisa de:
O Pix Plugin exige uma licença Lerian válida. Para detalhes de licença, veja a documentação de licença.
Estimativa antes de entrar em produção
Antes de processar transações reais, use a estimativa do Fees Engine para conferir sua configuração de tarifas. A estimativa permite:
- Ver de antemão a tarifa exata para um determinado valor de transação
- Conferir se as isenções funcionam como esperado
- Confirmar que as divisões proporcionais produzem a distribuição correta
- Testar casos-limite, como valores de fronteira e contas isentas
Próximos passos
Visão geral do Fees Engine
Entenda os pacotes de tarifas, as regras de cálculo e as opções de roteamento.
Usando o Fees Engine
Guia passo a passo para criar pacotes e processar tarifas.
Pix direto vs. Pix indireto
Compare os modelos de participação e escolha o caminho de conectividade certo.
Pix Lerian
Explore a interface unificada para pagamentos, chaves, cobranças e devoluções.