Por que essa combinação importa
Cada componente resolve uma camada específica do problema:
Juntos, esses três componentes formam um sistema de circuito fechado. As transações Pix chegam, o Fees Engine calcula as taxas automaticamente e o ledger registra cada movimentação — os valores bruto, líquido e de taxa — em uma única operação auditável.
Escolhendo seu modelo de participação Pix
O Plugin Pix suporta ambos os modelos de participação definidos pelo BACEN. A integração de taxas e o fluxo do ledger desta página se aplicam a ambos. Apenas a conexão com o BACEN muda.
Para uma comparação detalhada, veja Plugin Pix Direto vs. Indireto.
Cenário 1: Fintech lançando Pix com taxas automatizadas
Uma fintech planeja oferecer Pix aos seus clientes. Ela quer cobrar uma taxa fixa em cada Pix recebido (cash-in). A taxa cobre os custos operacionais e adiciona receita sem complexidade extra para o cliente. A lógica de taxas e a estrutura do ledger permanecem as mesmas nos dois modelos. Isso vale tanto se a fintech é um participante indireto (via BTG) quanto se é um participante direto (via JD).
O objetivo de negócio
- Oferecer pagamentos Pix instantâneos aos clientes finais
- Cobrar uma taxa transparente e configurável em transferências recebidas
- Registrar cada taxa no ledger para compliance e relatórios financeiros
- Lançar rapidamente, sem lógica de taxas customizada nem pipelines de reconciliação
Configurando com o Midaz
A fintech primeiro estrutura seu ambiente Midaz:1
Criar a Organização
Registre a fintech como uma Organização no Midaz. Esta é a entidade de nível superior que possui todos os ledgers, contas e transações.
2
Configurar o Ledger
Crie um Ledger para rastrear todas as transações de clientes e movimentações de taxas. O Plugin Pix e o Fees Engine compartilham este ledger.
3
Definir o Ativo
Registre BRL como o ativo operacional. Todas as transações Pix e cálculos de taxas usam este ativo.
4
Criar contas de clientes
Cada cliente recebe uma conta no ledger. Essas contas recebem créditos Pix e seguem as regras de taxas.
5
Criar contas de destino de taxas
Configure contas internas para receber créditos de taxas — por exemplo, uma conta “Receita de Taxas Pix”. A configuração do pacote do Fees Engine referencia essas contas.
6
Organizar com Segmentos
Use Segmentos para agrupar clientes por nível (ex.: Standard, Premium). Isso permite que você aplique diferentes pacotes de taxas a diferentes grupos.
Configurando o Fees Engine
Com a estrutura do ledger pronta, a fintech configura um pacote de taxas:- Tipo de taxa: Taxa 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 taxa para a conta interna “Receita de Taxas Pix”
- Isenções: Adicione as contas do nível Premium à lista de contas isentas
Você configura os pacotes de taxas uma vez, e o Fees Engine os aplica automaticamente. Quando uma transação Pix corresponde aos critérios do pacote (ledger, segmento, faixa de valor), o Fees Engine calcula e roteia a taxa sem nenhum passo manual.
Como uma transação flui
Quando um cliente recebe uma transferência Pix, eis o que acontece nos bastidores:1
Pix chega
A instituição remetente inicia um Pix. Seu provedor de conectividade (BTG para indireto, JD para direto) recebe a transação e notifica o Plugin Pix.
2
Transação é validada
O plugin valida o destinatário: verifica se a conta existe, está ativa e pode receber fundos. O plugin também verifica os dados do CRM e a validade da chave Pix.
3
Liquidação começa
Depois que o plugin confirma a transação, a liquidação começa. O plugin busca os detalhes da conta de destino no Midaz.
4
Taxas são calculadas automaticamente
O Fees Engine avalia a transação contra os pacotes de taxas disponíveis. Encontra um pacote correspondente e calcula a taxa fixa de R$ 1,50.
5
Ledger registra o quadro completo
O Midaz registra a transação com a distribuição de taxas em uma única operação:
- O Midaz credita a conta do cliente com o valor líquido (bruto menos taxa).
- O Midaz credita a conta de destino de taxa com R$ 1,50.
- Cada movimentação é rastreável, com precisão de partida dobrada.
6
Transação completa
O cliente vê o crédito Pix em sua conta. O ledger registra a taxa de forma transparente para relatórios e reconciliação.
O que isso desbloqueia
- Sem lógica de taxas customizada — o Fees Engine cuida do cálculo, do roteamento e das isenções.
- Ledger preciso — cada taxa é um lançamento no ledger, não apenas um metadado. Os auditores veem os mesmos números que seu time financeiro.
- Segmentação de clientes — o Fees Engine isenta os clientes Premium automaticamente por meio de contas isentas.
- Flexibilidade de taxas — altere os valores, adicione taxas percentuais ou introduza limites baseados em valor sem mudanças no seu pipeline de transações.
Cenário 2: Marketplace com Pix e taxas proporcionais
Um marketplace B2B conecta compradores e vendedores. Compradores pagam via Pix, e o marketplace cobra uma taxa de serviço em cada transação antes de distribuir o restante aos vendedores.
O objetivo de negócio
- Aceitar pagamentos Pix de compradores
- Cobrar uma taxa de serviço percentual em cada pagamento
- Distribuir o valor líquido proporcionalmente entre múltiplos vendedores quando um único pagamento cobre produtos de diferentes vendedores
- Manter uma trilha de auditoria clara para cada split e taxa
Configurando com o Midaz
O marketplace estrutura seu ambiente Midaz para refletir a natureza multi-parte de 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 de compradores, créditos de vendedores e taxas do marketplace.
3
Definir o Ativo
Registre BRL como o ativo operacional.
4
Criar contas de 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 relevantes.
5
Criar a conta de taxa do marketplace
Uma conta interna (ex.: “Taxa de Serviço do Marketplace”) recebe a porção de taxa de cada transação.
6
Usar Segmentos para níveis de vendedores
Agrupe os vendedores em segmentos (ex.: Vendedores Standard, Vendedores Parceiros) para aplicar diferentes taxas por grupo.
Configurando o Fees Engine
O marketplace configura um pacote de taxas com distribuição proporcional:- Tipo de taxa: 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 taxas proporcionalmente entre as contas de origem quando uma única transação cobre múltiplos vendedores
- Roteamento: Os créditos de taxa vão para a conta “Taxa de Serviço do Marketplace”
- Dedutível: O Fees Engine deduz a taxa do valor dos vendedores (
isDeductibleFrom: true), então o comprador sempre envia o valor total
Como uma transação flui
Um comprador adquire R$ 1.000 em produtos de três vendedores:1
Comprador envia Pix
O comprador escaneia um QR Code ou usa uma chave Pix para enviar R$ 1.000 ao marketplace.
2
Pix chega ao Plugin
O provedor de conectividade processa a transação e notifica o Plugin Pix.
3
Taxas são calculadas com split proporcional
O Fees Engine calcula uma taxa de 3% (R$ 30,00) e distribui proporcionalmente:
- Vendedor A: R 485,00 líquido)
- Vendedor B: R 291,00 líquido)
- Vendedor C: R 194,00 líquido)
4
Ledger registra cada movimentação
O Midaz cria a transação com distribuição completa:
- Conta do Vendedor A: creditada R$ 485,00
- Conta do Vendedor B: creditada R$ 291,00
- Conta do Vendedor C: creditada R$ 194,00
- Conta de taxa do marketplace: creditada R$ 30,00
- Total: R$ 1.000,00 — totalmente balanceado
5
Vendedores e marketplace são liquidados
Cada vendedor vê seu crédito líquido. O marketplace vê a receita de taxas. Cada número tem respaldo em um lançamento no ledger.
O que isso desbloqueia
- Split de receita automatizado — o Fees Engine cuida da distribuição proporcional entre qualquer número de contas.
- Precificação transparente para vendedores — cada vendedor vê a taxa exata e o motivo dela.
- Ledger balanceado — o valor bruto de entrada é igual à soma de todos os créditos de saída. Sem diferenças de arredondamento, sem ajustes manuais.
- Taxas configuráveis — altere o percentual, adicione mínimos fixos ou isente parceiros específicos — tudo pela configuração do pacote de taxas.
O que você precisa para começar
Para executar essa configuração, sua instituição precisa de:
O Plugin Pix e o Fees Engine requerem uma licença Lerian válida — o Fees Engine sob o nível Enterprise do Midaz. Para detalhes de licença, veja a documentação de Licença.
Estimando antes de ir para produção
Antes de processar transações reais, use a estimativa do Fees Engine para verificar sua configuração de taxas. A estimativa permite que você:
- Visualize a taxa exata para um dado valor de transação
- Verifique se as isenções funcionam como esperado
- Confirme que os splits proporcionais produzem a distribuição correta
- Teste casos extremos como valores limítrofes e contas isentas
Próximos passos
Visão geral do Fees Engine
Entenda pacotes de taxas, regras de cálculo e opções de roteamento.
Usando o Fees Engine
Guia passo a passo para criar pacotes e processar taxas.
Pix Direto vs. Indireto
Compare modelos de participação e escolha o plugin certo.
Pix Switch
Explore a arquitetura completa do Plugin Pix e modelos de conexão.