> ## 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. # Pix Switch > Pix Switch é o plugin Pix unificado da Lerian: uma camada de aplicação, qualquer provedor, com orquestração, chaves, QR Codes e disputas. O Pix Switch é o plugin Pix da Lerian. Ele oferece à sua instituição tudo o que é necessário para operar o Pix na camada de aplicação -- orquestração de transações, gestão de chaves, QR Codes, devoluções, resolução de disputas e muito mais -- por meio de um único produto unificado. A ideia central: **um plugin, qualquer provedor**. Você escolhe o provedor de conectividade que corresponde ao seu modelo de participação. O Pix Switch cuida do resto. A Lerian é uma **provedora de tecnologia**. Nós não somos um PSP, não somos um PSTI e não fornecemos conectividade SPI/DICT. A conectividade regulada é sempre realizada por um provedor externo -- seja um participante direto ou um PSTI certificado contratado pela sua instituição. A arquitetura e os contratos descritos nesta página refletem o design atual do produto Pix Switch. # Por que o Pix Switch *** Historicamente, oferecer Pix com diferentes provedores de conectividade significava manter **plugins separados e isolados** -- um por provedor, cada um com seu próprio código, contratos de API e padrões de integração. Isso criava problemas reais: * **Lógica de negócio duplicada** -- As mesmas regras do Pix precisavam ser implementadas e mantidas de forma independente em cada plugin * **Contratos de API diferentes** -- Cada integração com provedor expunha uma API diferente para o cliente, dificultando a troca ou adição de provedores * **Maior custo de manutenção** -- Correções de bugs, atualizações regulatórias e novas funcionalidades precisavam ser aplicadas separadamente em cada plugin * **Sem portabilidade** -- Migrar de um provedor para outro exigia uma reintegração completa O Pix Switch resolve isso centralizando toda a lógica Pix em um único produto com uma **API unificada** e uma **Provider Adapter Layer** que cuida da tradução específica de cada provedor. O resultado: uma integração, qualquer provedor, sem retrabalho quando suas necessidades de conectividade mudarem. # O que o Pix Switch fornece *** O Pix Switch entrega uma camada completa de **orquestração Pix** que gerencia todo o ciclo de vida das operações Pix: * **Fluxos de cash-out e cash-in** -- Envie e receba pagamentos Pix com gestão completa do ciclo de vida das mensagens * **Gestão de chaves Pix (DICT)** -- Crie, atualize, exclua e resolva a propriedade de chaves Pix * **Geração de QR Codes estáticos e dinâmicos** -- Emita QR Codes para iniciação de pagamentos em todos os formatos suportados * **Orquestração do ciclo de vida do MED** -- Gerencie o Mecanismo Especial de Devolução de ponta a ponta * **Tratamento de devoluções** -- Processe devoluções totais e parciais com sequenciamento regulatório adequado * **Webhooks, processamento de eventos e workers em background** -- Reaja a eventos do provedor em tempo real e execute jobs assíncronos de forma confiável * **Integração nativa com o Midaz** -- O Midaz é o ledger obrigatório para o Pix Switch, fornecendo validação de contas, verificação de saldos, lançamentos de débito/crédito e roteamento # Como funciona *** O Pix Switch utiliza uma **Camada de Adaptação de Provedores** para separar sua integração das especificidades de qualquer provedor de conectividade individual. O plugin expõe uma **API única** para sua aplicação. Por trás dessa API, um adaptador de provedor traduz cada operação -- transações, consultas de chaves, registros de QR Code, devoluções -- no protocolo e formato exigidos pelo provedor configurado. Sua instituição seleciona qual provedor usar durante a configuração. O plugin resolve todo o resto. Essa arquitetura significa que trocar de provedor ou suportar modelos de participação adicionais não requer reescrever sua integração. Você altera a configuração. A API permanece a mesma. A conectividade regulada é sempre externa. O Pix Switch não se conecta ao BACEN diretamente. Um **participante direto** ou um **PSTI certificado** fornece a camada de gateway SPI/DICT. O Pix Switch opera acima dessa camada, gerenciando toda a lógica de negócios do Pix. # Modelos de participação *** O BACEN define dois modelos regulatórios de participação no Pix: **direto** (sua instituição se conecta ao BACEN por conta própria) e **indireto** (você se conecta por meio de um participante direto licenciado). Para uma explicação detalhada de cada modelo, consulte [O que é Pix?](/pt/rails/pix/pix-overview). No Pix Switch, o modelo de participação é uma **configuração** -- não um produto diferente. Ambos os modelos são suportados pela **Provider Adapter Layer**. Você escolhe um provedor que corresponda ao seu status regulatório, e a API do plugin permanece a mesma. Trocar de provedor ou evoluir seu modelo de participação não exige reintegração. # Integrações no ecossistema Lerian *** O Pix Switch requer o **Midaz** como seu ledger principal. Essa integração nativa simplifica: * Validação de contas * Verificação de saldos * Lançamentos de débito/crédito * Roteamento * Regras de negócio (tarifas, autorizações, gatilhos antifraude) O Pix Switch também se conecta com outros produtos do ecossistema Lerian: * **CRM (Midaz CRM)** -- Gestão de relacionamento com clientes e entidades * **Fees Engine** -- Cálculo e cobrança automatizada de tarifas * **Access Manager** -- Autenticação, autorização e governança de credenciais * **Reporter** -- Relatórios regulatórios e prontos para COSIF * **Matcher** -- Conciliação e correspondência de identidade * **Flowker** -- Orquestração de workflows * **Tracer** -- Observabilidade e rastreamento distribuído Juntos, eles formam uma stack operacional completa para ambientes Pix de alto volume. # Modelo de implantação *** O Pix Switch segue os mesmos modelos de implantação disponíveis em toda a plataforma Lerian: **SaaS** e **BYOC** (Bring Your Own Cloud). Ambos dão acesso ao produto completo — a diferença é quem opera a infraestrutura. * **SaaS** -- A Lerian hospeda e opera o Pix Switch em um ambiente totalmente gerenciado. Sua equipe foca na configuração do produto e na integração. A Lerian cuida da infraestrutura, atualizações e disponibilidade. * **BYOC** -- Sua instituição implanta e opera o Pix Switch em sua própria infraestrutura — seja em cloud pública, cloud privada ou on-premises. Para uma comparação detalhada de ambos os modelos, consulte [SaaS e BYOC](/pt/deployment-models). # Público-alvo *** O Pix Switch é projetado para instituições que: * Participam do arranjo Pix (ou pretendem participar) * Possuem um **ISPB** válido (identificador atribuído pelo BACEN a instituições financeiras no Brasil) * São proprietárias do ledger no nível de negócio -- sua instituição controla contas e saldos, independentemente de onde a infraestrutura é executada Seja sua equipe gerenciando a própria infraestrutura (BYOC) ou preferindo um ambiente totalmente gerenciado (SaaS), o Pix Switch se adapta ao seu modelo operacional. **Não adequado para** instituições onde um terceiro controla o ledger ou a gestão de contas no nível de negócio. Se suas contas e saldos residem dentro do domínio de um provedor BaaS -- não apenas de sua infraestrutura -- o Pix Switch não é a opção adequada. A instituição deve ser proprietária da camada de ledger no nível lógico, independentemente do modelo de implantação. # Requisitos para operar *** Antes de adotar o Pix Switch, sua instituição deve possuir: * Um **ISPB** válido registrado no BACEN * Um **contrato com um provedor de conectividade** -- um participante direto (para participação indireta) ou um PSTI certificado (para participação direta), dependendo do seu modelo regulatório * **Propriedade lógica do ledger** -- o Midaz deve estar implantado e operacional, com sua instituição controlando contas e saldos **Requisitos adicionais para BYOC:** * Seu próprio **ambiente cloud ou on-premise** para hospedar o plugin * **Prontidão de DevOps e SRE** -- sua equipe gerencia implantação, monitoramento, atualizações e resposta a incidentes * **Propriedade de segurança e conformidade** -- sua instituição é responsável por controle de acesso, redundância, observabilidade e trilhas de auditoria No modelo **SaaS**, a Lerian gerencia infraestrutura, implantação e disponibilidade operacional. Sua instituição permanece responsável pela **conectividade regulada** e pela **configuração de negócio**. # Vantagens *** ### Integrações nativas ao ecossistema Conecte-se ao Midaz, Fees Engine, CRM, Matcher, Flowker, Reporter, Tracer e Access Manager de forma nativa. Cada integração é construída na plataforma, não acoplada externamente. ### Customização Estenda ou modifique a lógica de negócios para atender aos requisitos específicos da sua instituição. Adapte-se a mudanças regulatórias no seu próprio ritmo. ### Eficiência econômica Elimine a dependência de intermediários em múltiplas camadas que adicionam custo sem adicionar controle. No SaaS, entre em produção sem investimento inicial em infraestrutura. No BYOC, dimensione a infraestrutura para sua demanda real. ### Caminho mais rápido para produção (SaaS) Entre em produção sem provisionar ou gerenciar infraestrutura. A Lerian cuida das operações, atualizações e disponibilidade -- sua equipe foca em construir produtos financeiros. ### Controle total e soberania de dados (BYOC) Execute tudo na sua própria infraestrutura. Aplique suas próprias políticas de IAM, padrões de criptografia e frameworks de governança. Defina regras de roteamento, políticas de negócio e práticas operacionais. Seus dados nunca saem do seu ambiente. # Trade-offs *** Cada modelo de implantação traz trade-offs diferentes. ### SaaS * **Menos controle sobre a infraestrutura** -- A Lerian gerencia o ambiente. Você configura o produto, não a plataforma por baixo. * **Dados hospedados pela Lerian** -- Seus dados residem em infraestrutura cloud gerenciada pela Lerian. Se seus requisitos regulatórios exigem residência de dados em seu próprio ambiente, escolha BYOC. ### BYOC * **Requer maturidade técnica** -- Sua instituição precisa de capacidades de DevOps, ferramentas de observabilidade e expertise em gestão operacional. * **Requer disciplina de governança** -- Segurança, uptime, conformidade e prontidão para auditoria devem ser mantidos pela sua equipe. * **Mais configuração inicial** -- Flexibilidade significa mais orquestração e parametrização durante a configuração inicial. Planeje um processo estruturado de onboarding. * **Responsabilidade operacional** -- Sua instituição gerencia atualizações de software, patches, escalabilidade e planos de continuidade. A Lerian fornece o software e as ferramentas -- sua equipe o opera. Para ajuda na escolha do modelo adequado, consulte [SaaS e BYOC](/pt/deployment-models#which-model-is-right-for-you). # Casos de uso do Pix com o Midaz *** Veja como o Pix Switch e o Midaz trabalham juntos na prática: Modele fluxos de transferência Pix validados e reutilizáveis usando Rotas de Transação e Rotas de Operação -- de transferências simples a cobrança de tarifas. Combine o Pix Switch com o Fees Engine para gestão de tarifas transparente e automatizada em fintechs e marketplaces.