> ## 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. # Midaz com Pix e taxas automatizadas > Combine Midaz, o Plugin Pix e o Fees Engine para lançar Pix com gestão automática de tarifas e rastreabilidade de auditoria completa. Oferecer Pix é apenas o começo. O que transforma um trilho de pagamento em um produto financeiro é como você gerencia taxas, distribui receita e mantém uma trilha de auditoria clara para cada transação. Ao combinar o **Midaz** (o ledger), o **Plugin Pix** (conectividade Pix) e o **Fees Engine** (lógica de taxas automatizada), instituições podem lançar operações Pix com gestão de taxas integrada — sem middleware customizado, sem reconciliação manual e sem lacunas na sua contabilidade. Esta página apresenta dois cenários reais onde essa combinação entrega valor imediato. ## Por que essa combinação importa *** Cada componente resolve uma camada específica do problema: | Componente | Papel | | --------------- | ----------------------------------------------------------------------------------------------------------------- | | **Midaz** | Ledger central — registra cada débito, crédito e movimentação de taxa com precisão de partida dobrada | | **Plugin Pix** | Conectividade Pix — orquestra transações, DICT, QR Codes e liquidação através do modelo de participação escolhido | | **Fees Engine** | Automação de taxas — calcula, distribui e roteia taxas com base em pacotes configuráveis | Quando conectados, esses três componentes criam um **sistema de circuito fechado**: transações Pix chegam, taxas são calculadas automaticamente e o ledger registra cada movimentação — 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 descritos nesta página se aplicam igualmente a ambos — a diferença está em como sua instituição se conecta à infraestrutura do BACEN. | | Pix Indireto | Pix Direto | | -------------------------------- | --------------------------------------------------------------- | ------------------------------------------------------ | | **Como conecta** | Através de um Participante Direto (ex.: BTG) | Diretamente ao SPI/DICT via PSTI certificado (ex.: JD) | | **Ideal para** | Fintechs e instituições de pagamento buscando onboarding rápido | Bancos e IFs reguladas com autonomia operacional total | | **Responsabilidade regulatória** | Compartilhada com o Participante Direto | Totalmente da instituição | | **Time to market** | Semanas | Mais longo, mas com controle máximo | | **Integração com Fees Engine** | Nativa | Nativa | | **Integração com Midaz** | Obrigatória | Obrigatória | **Pix Indireto via BTG** está em produção e é o caminho mais rápido para oferecer Pix com compliance de nível enterprise. Sua instituição se conecta pela infraestrutura do BTG, eliminando a necessidade de certificação ISPB ou conectividade direta com o BACEN. **Pix Direto via JD** — explore suas APIs e funcionalidades na [referência da API](/pt/rails/pix/pix-switch). Para uma comparação detalhada, veja [Plugin Pix Direto vs. Indireto](/pt/rails/pix/pix-switch). ## Cenário 1: Fintech lançando Pix com taxas automatizadas *** Uma fintech está se preparando para oferecer Pix aos seus clientes. Ela precisa cobrar uma taxa fixa em cada Pix recebido (cash-in) para cobrir custos operacionais e gerar receita — sem adicionar complexidade à experiência do cliente. Seja operando como participante indireto (via BTG) ou como participante direto (via JD), a lógica de taxas e a estrutura do ledger permanecem as mesmas. ### 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 construir lógica de taxas customizada ou pipelines de reconciliação ### Configurando com o Midaz A fintech começa estruturando seu ambiente Midaz: 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. Crie um Ledger para rastrear todas as transações de clientes e movimentações de taxas. Este ledger é compartilhado pelo Plugin Pix e pelo Fees Engine. Registre **BRL** como o ativo operacional. Todas as transações Pix e cálculos de taxas usam este ativo. Cada cliente recebe uma conta no ledger. Essas contas recebem créditos Pix e estão sujeitas às regras de taxas. Configure contas internas para receber créditos de taxas — por exemplo, uma conta "Receita de Taxas Pix". Essas são referenciadas na configuração do pacote do Fees Engine. Use Segmentos para agrupar clientes por nível (ex.: Standard, Premium). Isso permite aplicar 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**: Créditos de taxa são direcionados para a conta interna "Receita de Taxas Pix" * **Isenções**: Contas do nível Premium são adicionadas à lista de contas isentas O Fees Engine suporta múltiplos métodos de cálculo — taxas fixas, taxas percentuais ou uma regra "máximo entre tipos" que aplica o maior valor. Para este cenário, uma taxa fixa mantém a precificação previsível para os clientes. Pacotes de taxas são configurados uma vez e aplicados 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 qualquer intervenção manual. ### Como uma transação flui Quando um cliente recebe uma transferência Pix, eis o que acontece nos bastidores: 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. O plugin valida o destinatário: verifica se a conta existe, está ativa e pode receber fundos. Dados do CRM e validade da chave Pix também são verificados. Uma vez confirmada a transação, o processo de liquidação inicia. O plugin busca os detalhes da conta de destino no Midaz. 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. O Midaz registra a transação com a distribuição de taxas em uma única operação: * A conta do cliente é creditada com o **valor líquido** (bruto menos taxa). * A conta de destino de taxa é creditada com **R\$ 1,50**. * Cada movimentação é rastreável, com precisão de partida dobrada. O cliente vê o crédito Pix em sua conta. A taxa é registrada de forma transparente, disponível para relatórios e reconciliação. ### O que isso desbloqueia * **Sem lógica de taxas customizada** — o Fees Engine cuida do cálculo, roteamento e isenções. * **Ledger preciso** — cada taxa é um lançamento no ledger, não apenas metadado. Auditores veem os mesmos números que seu time financeiro. * **Segmentação de clientes** — clientes Premium podem ser isentos automaticamente usando contas isentas. * **Flexibilidade de taxas** — altere valores, adicione taxas percentuais ou introduza limites baseados em valor sem mudar 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 valor 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: Registre o marketplace como uma Organização no Midaz. Crie um único Ledger para gerenciar todos os fluxos de pagamento — pagamentos de compradores, créditos de vendedores e taxas do marketplace. Registre **BRL** como o ativo operacional. Cada vendedor recebe uma conta no ledger. Quando um comprador paga via Pix, o valor líquido é distribuído entre as contas dos vendedores relevantes. Uma conta interna (ex.: "Taxa de Serviço do Marketplace") recebe a porção de taxa de cada transação. Vendedores podem ser agrupados 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**: Taxas são divididas proporcionalmente entre as contas de origem quando múltiplos vendedores participam de uma única transação * **Roteamento**: Créditos de taxa vão para a conta "Taxa de Serviço do Marketplace" * **Dedutível**: A taxa é deduzida do valor recebido pelos 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: | Vendedor | Participação | Valor bruto | | ---------- | ------------ | ----------- | | Vendedor A | 50% | R\$ 500,00 | | Vendedor B | 30% | R\$ 300,00 | | Vendedor C | 20% | R\$ 200,00 | O comprador escaneia um QR Code ou usa uma chave Pix para enviar R\$ 1.000 ao marketplace. O provedor de conectividade processa a transação e notifica o Plugin Pix. O Fees Engine calcula uma taxa de 3% (R\$ 30,00) e distribui proporcionalmente: * Vendedor A: R$ 15,00 de taxa (R$ 485,00 líquido) * Vendedor B: R$ 9,00 de taxa (R$ 291,00 líquido) * Vendedor C: R$ 6,00 de taxa (R$ 194,00 líquido) 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 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 sabe exatamente qual taxa foi cobrada e por quê. * **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: | Requisito | Detalhes | | ----------------------------- | ------------------------------------------------------------------------------------------------------- | | **Midaz** (v3.x.x+) | Ledger central para gestão de contas e registro de transações | | **Plugin Pix** | Conectividade Pix — escolha Indireto (via BTG) ou Direto (via JD) baseado no seu modelo de participação | | **Fees Engine** | Cálculo e roteamento automatizado de taxas | | **CRM** | Metadados de clientes e contas usados durante a validação Pix | | **Infraestrutura** | Nuvem própria (BYOC) ou ambiente on-premise | | **Contrato de conectividade** | Acordo com BTG (indireto) ou JD/PSTI (direto) dependendo do seu modelo | O Plugin Pix e o Fees Engine requerem uma licença Lerian válida. Para detalhes de licença, veja a [documentação de Licença](/pt/reference/lerians-license). ## Estimando antes de ir para produção *** Antes de processar transações reais, use a funcionalidade de estimativa do Fees Engine para validar sua configuração de taxas. Estimativas permitem: * Visualizar exatamente como as taxas serão calculadas para um dado valor de transação * Verificar que isenções funcionam como esperado * Confirmar que splits proporcionais produzem a distribuição correta * Testar casos extremos como valores limítrofes e contas isentas Isso é especialmente útil durante o onboarding, quando você está finalizando estruturas de taxas com stakeholders de negócio antes do lançamento. Use o endpoint [Estimar Taxas de Transação](/pt/reference/midaz/plugins/fees-engine/simulate-fees) para testar pacotes de taxas específicos sem escrever nada no ledger. ## Próximos passos *** Entenda pacotes de taxas, regras de cálculo e opções de roteamento. Guia passo a passo para criar pacotes e processar taxas. Compare modelos de participação e escolha o plugin certo. Explore a arquitetura completa do Plugin Pix e modelos de conexão.