> ## 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 tarifas automatizadas > Lance o Pix com tarifas automatizadas combinando o Midaz, o Pix Plugin e o Fees Engine para cash-in e cash-out com trilhas de auditoria completas em partidas dobradas. Para transformar um trilho de pagamento em produto, você gerencia tarifas, divide receita e mantém uma trilha de auditoria clara para cada transação. Você combina o **Midaz** (o ledger), o **Pix Plugin** (conectividade Pix) e o **Fees Engine** (lógica de tarifa automatizada, parte do Midaz). Juntos, eles lançam operações Pix com gestão de tarifas embutida, sem middleware customizado, sem conciliação manual e sem lacunas na contabilidade. Esta página percorre dois cenários. ## 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 movimento de tarifa com precisão de partidas dobradas | | **Pix Plugin** | Conectividade Pix — cuida da orquestração de transações, do DICT, dos QR Codes e da liquidação pelo modelo de participação que você escolher | | **Fees Engine** | Automação de tarifas — calcula, divide e roteia tarifas com base em pacotes configuráveis | 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. | | Pix indireto | Pix direto | | -------------------------------- | -------------------------------------------------------------------- | -------------------------------------------------------------------------------- | | **Como se conecta** | Por meio de um participante direto (por exemplo, BTG) | Direto ao SPI/DICT, por um PSTI certificado (por exemplo, JD) ou pelo Lerian SPI | | **Melhor para** | Fintechs e instituições de pagamento que buscam um onboarding rápido | Bancos e IFs reguladas com autonomia operacional total | | **Carga regulatória** | Compartilhada com o participante direto | Toda da instituição | | **Time to market** | Semanas | Mais longo, mas com controle máximo | | **Integração com o Fees Engine** | Nativa | Nativa | | **Integração com o Midaz** | Obrigatória | Obrigatória | O **Pix indireto via BTG** está pronto para produção. Sua instituição se conecta pela infraestrutura do BTG, então você dispensa a certificação de ISPB e a conectividade direta com o BACEN. **Pix direto via JD**: explore os recursos no [guia de participação direta](/pt/interfaces/pix-jd/direct-pix-via-jd). Para uma comparação detalhada, veja [Modelos de participação no Pix](/pt/interfaces/pix/pix-modalities). ## 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: 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. 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. Registre **BRL** como o ativo de operação. Todas as transações Pix e todos os cálculos de tarifa usam esse ativo. Cada cliente recebe uma conta no ledger. Essas contas recebem os créditos Pix e seguem as regras de tarifa. 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. 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 O Fees Engine oferece suporte a vários métodos de cálculo: tarifas fixas, tarifas percentuais ou uma regra "max between" que aplica o maior valor. Neste cenário, uma tarifa fixa mantém a precificação previsível para os clientes. 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: 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. 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. Depois que o plugin confirma a transação, a liquidação começa. O plugin busca no Midaz os dados da conta de destino. 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. 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. 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: Registre o marketplace como uma organização no Midaz. Crie um único ledger para gerenciar todos os fluxos de pagamento: pagamentos dos compradores, créditos aos vendedores e tarifas do marketplace. Registre **BRL** como o ativo de operação. 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. Uma conta interna (por exemplo, "Marketplace Service Fee") recebe a parcela de tarifa de cada transação. 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: | 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 lê um QR Code ou usa uma chave Pix para enviar R\$ 1.000 ao marketplace. O provedor de conectividade processa a transação e avisa o Pix Plugin. O Fees Engine calcula uma tarifa de 3% (R\$ 30,00) e a distribui proporcionalmente: * Vendedor A: R$ 15,00 de tarifa (R$ 485,00 líquidos) * Vendedor B: R$ 9,00 de tarifa (R$ 291,00 líquidos) * Vendedor C: R$ 6,00 de tarifa (R$ 194,00 líquidos) 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) 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: | Requisito | Detalhes | | ----------------------------- | ------------------------------------------------------------------------------------------------------- | | **Midaz** (v4.x.x+) | Ledger central para gestão de contas e registro de transações | | **Pix Plugin** | Conectividade Pix — escolha indireto (via BTG) ou direto (via JD) conforme o seu modelo de participação | | **Fees Engine** | Cálculo e roteamento automatizados de tarifas — um recurso do Midaz Enterprise, com deploy independente | | **CRM** | Dados de clientes e contas para a validação do Pix — parte do Midaz | | **Infraestrutura** | Nuvem autogerenciada (BYOC) ou ambiente on-premise | | **Contrato de conectividade** | Acordo com o BTG (indireto) ou com JD/PSTI (direto), conforme o seu modelo | 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](/pt/start-here/evaluate-and-deploy/lerians-license). ## 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 Isso ajuda mais durante o onboarding, antes de você fechar as estruturas finais de tarifa com as áreas de negócio. Use o endpoint [Estimate Transaction Fees](/pt/reference/products/midaz/v2/estimate-fee-calculation) para testar pacotes de tarifas específicos sem gravar no ledger. ## Próximos passos *** Entenda os pacotes de tarifas, as regras de cálculo e as opções de roteamento. Guia passo a passo para criar pacotes e processar tarifas. Compare os modelos de participação e escolha o caminho de conectividade certo. Explore a interface unificada para pagamentos, chaves, cobranças e devoluções.