> ## 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** (orquestração da aplicação Pix) e o **Fees Engine** (lógica de tarifa automatizada, parte do Midaz). Juntos, eles oferecem operações Pix com gestão de tarifas e lançamentos no ledger na mesma plataforma. ## O que cada componente faz *** Cada componente resolve uma camada específica do problema: | Componente | Papel | | - | - | | **Midaz** | Ledger central que registra cada débito, crédito e movimento de tarifa com precisão de partidas dobradas | | **Pix Plugin** | Camada de aplicação Pix que cuida da orquestração de transações, do DICT, dos QR Codes e dos workflows voltados à liquidação com o provedor. Pix BTG e Pix JD são interfaces disponibilizadas separadamente que se conectam por meio de um parceiro. | | **Fees Engine** | Automação de tarifas que calcula, divide e roteia tarifas com base em pacotes configuráveis | 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. | | Pix indireto | Pix direto | | - | - | - | | **Como se conecta** | Por meio de um participante direto (por exemplo, BTG) | Por meio de um PSTI certificado (por exemplo, JD) | | **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 | > [!TIP] > > 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](https://docs.lerian.studio/pt/interfaces/pix-jd/direct-pix-via-jd.md). Para uma comparação detalhada, veja [Modelos de participação no Pix](https://docs.lerian.studio/pt/interfaces/pix/pix-modalities.md). ## 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 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. > [!NOTE] > > 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. Em um Pix que uma conta com um [plano de tarifas](https://docs.lerian.studio/pt/products/midaz/fees/account-plans.md) ativo envia, o plano cobra essa conta, não os pacotes de tarifas, e só quando uma tarifa do plano corresponde ao Pix. ### 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: | Requisito | Detalhes | | - | - | | **Midaz** (v4.x.x+) | Ledger central para gestão de contas e registro de transações | | **Pix Plugin** | Orquestração da aplicação Pix. Pix BTG e Pix JD são interfaces separadas que se conectam por meio de um parceiro | | **Fees Engine** | Cálculo e roteamento automatizados de tarifas (parte do Midaz) | | **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 | > [!NOTE] > > O Pix Plugin exige uma licença Lerian válida. Para detalhes de licença, veja a [documentação de licença](https://docs.lerian.studio/pt/start-here/evaluate-and-deploy/lerians-license.md). ## 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. > [!TIP] > > Use o endpoint [Estimate Transaction Fees](https://docs.lerian.studio/pt/reference/products/midaz/v2/estimate-fee-calculation.md) para testar pacotes de tarifas específicos sem gravar no ledger. ## Próximos passos *** > [card] [Visão geral do Fees Engine](https://docs.lerian.studio/pt/products/midaz/fees/fees-engine-overview.md) > > Entenda os pacotes de tarifas, as regras de cálculo e as opções de roteamento. > [card] [Usando o Fees Engine](https://docs.lerian.studio/pt/products/midaz/fees/using-fee-engine.md) > > Guia passo a passo para criar pacotes e processar tarifas. > [card] [Pix direto vs. Pix indireto](https://docs.lerian.studio/pt/interfaces/pix/pix-modalities.md) > > Compare os modelos de participação e escolha o caminho de conectividade certo. This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.