Por que essa combinação importa
Cada componente resolve uma camada específica do problema:
Juntas, essas três partes formam um sistema de circuito fechado. As transações Pix chegam, o Fees Engine calcula as tarifas automaticamente e o ledger registra cada movimento (valores bruto, líquido e de tarifa) em uma única operação auditável.
Escolha do seu modelo de participação no Pix
O Pix Plugin oferece suporte aos 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. Apenas a conexão com o BACEN muda.
Para uma comparação detalhada, veja Modelos de participação no Pix.
Cenário 1: 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 de forma transparente para relatórios e conciliação.
O que isso destrava
- 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, não apenas metadados. 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.
Cenário 2: marketplace com Pix e tarifas proporcionais
Um marketplace B2B conecta compradores e vendedores. Os compradores pagam via Pix, e o marketplace cobra uma tarifa de serviço em cada transação antes de distribuir o restante aos vendedores.
O objetivo de negócio
- Aceitar pagamentos Pix dos compradores
- Cobrar uma tarifa de serviço percentual em cada pagamento
- Distribuir o valor líquido proporcionalmente entre vários vendedores quando um único pagamento cobre produtos de vendedores diferentes
- Manter uma trilha de auditoria clara para cada divisão e cada tarifa
Configuração no Midaz
O marketplace estrutura seu ambiente Midaz para refletir a natureza multiparte das suas operações:1
Criar a organização
Registre o marketplace como uma organização no Midaz.
2
Configurar o ledger
Crie um único ledger para gerenciar todos os fluxos de pagamento: pagamentos dos compradores, créditos aos vendedores e tarifas do marketplace.
3
Definir o ativo
Registre BRL como o ativo de operação.
4
Criar as contas dos vendedores
Cada vendedor recebe uma conta no ledger. Quando um comprador paga via Pix, o Midaz distribui o valor líquido entre as contas dos vendedores envolvidos.
5
Criar a conta de tarifa do marketplace
Uma conta interna (por exemplo, “Marketplace Service Fee”) recebe a parcela de tarifa de cada transação.
6
Usar segmentos para níveis de vendedor
Agrupe os vendedores em segmentos (por exemplo, Standard Sellers, Partner Sellers) para aplicar percentuais de tarifa diferentes por grupo.
Configuração do Fees Engine
O marketplace configura um pacote de tarifas com distribuição proporcional:- Tipo de tarifa: 3% do valor da transação
- Escopo: aplicada a todos os pagamentos Pix recebidos no ledger do marketplace
- Distribuição: o Fees Engine divide as tarifas proporcionalmente entre as contas de origem quando uma única transação cobre vários vendedores
- Roteamento: os créditos de tarifa vão para a conta “Marketplace Service Fee”
- Dedutível: o Fees Engine deduz a tarifa do valor dos vendedores (
isDeductibleFrom: true), então o comprador sempre envia o valor cheio
Como uma transação flui
Um comprador adquire R$ 1.000 em produtos de três vendedores:1
O comprador envia o Pix
O comprador lê um QR Code ou usa uma chave Pix para enviar R$ 1.000 ao marketplace.
2
O Pix chega ao plugin
O provedor de conectividade processa a transação e avisa o Pix Plugin.
3
As tarifas são calculadas com divisão proporcional
O Fees Engine calcula uma tarifa de 3% (R$ 30,00) e a distribui proporcionalmente:
- Vendedor A: R 485,00 líquidos)
- Vendedor B: R 291,00 líquidos)
- Vendedor C: R 194,00 líquidos)
4
O ledger registra cada movimento
O Midaz cria a transação com a distribuição completa:
- Conta do vendedor A: crédito de R$ 485,00
- Conta do vendedor B: crédito de R$ 291,00
- Conta do vendedor C: crédito de R$ 194,00
- Conta de tarifa do marketplace: crédito de R$ 30,00
- Total: R$ 1.000,00 (totalmente balanceado)
5
Vendedores e marketplace são liquidados
Cada vendedor vê o próprio crédito líquido. O marketplace vê a receita de tarifa. Cada número corresponde a um lançamento no ledger.
O que isso destrava
- Divisão de receita automatizada: o Fees Engine cuida da distribuição proporcional para qualquer número de contas.
- Precificação transparente para os vendedores: cada vendedor vê a tarifa exata e o motivo dela.
- Ledger balanceado: o valor bruto que entra é igual à soma de todos os créditos que saem. Sem diferenças de arredondamento, sem ajustes manuais.
- Percentuais configuráveis: mude o percentual da tarifa, acrescente mínimos fixos ou isente parceiros específicos, tudo pela configuração do pacote de tarifas.
O que você precisa para começar
Para rodar essa configuração, sua instituição precisa de:
O Pix Plugin e o Fees Engine exigem uma licença Lerian válida. O Fees Engine está no nível Midaz Enterprise. 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.