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 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?. 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)
- CRM (Midaz CRM) — Gestão de relacionamento com clientes e entidades
- Fee 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
Modelo de implantação
O Pix Switch é fornecido como software de aplicação standalone que sua instituição instala e opera em seu próprio ambiente:
- BYOC (Bring Your Own Cloud) — Implante no provedor de cloud de sua preferência
- On-premise — Execute em seu próprio data center
Público-alvo
O Pix Switch é projetado para instituições que:
- Participam do arranjo Pix (ou pretendem participar)
- Mantêm seu próprio ledger e controlam contas e saldos dos clientes
- Possuem um ISPB válido (identificador atribuído pelo BACEN a instituições financeiras no Brasil)
- Gerenciam seus próprios ambientes de produção
- Preferem autonomia em vez de processamento terceirizado
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
- Seu próprio ambiente cloud ou on-premise para hospedar o plugin
- Controle total do ledger — o Midaz deve estar implantado e operacional
- 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
Vantagens
Controle total
Execute tudo na sua própria infraestrutura. Defina regras de roteamento, políticas de negócio, limites e práticas operacionais sem dependências externas.Segurança e autonomia
Aplique suas próprias políticas de IAM, padrões de criptografia e frameworks de governança. Seus dados nunca saem do seu ambiente.Eficiência econômica
Dimensione a infraestrutura para sua demanda real. Elimine a dependência de intermediários em múltiplas camadas que adicionam custo sem adicionar controle.Integrações nativas ao ecossistema
Conecte-se ao Midaz, Fee 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.Trade-offs
O Pix Switch oferece máximo controle, mas esse controle vem com responsabilidades.
Requer maturidade técnica
Sua instituição precisa de capacidades de DevOps, ferramentas de observabilidade e expertise em gestão operacional. Este não é um serviço gerenciado.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 a documentação — sua equipe o opera. Este modelo é mais adequado para instituições que valorizam autonomia, escalabilidade e otimização de custos a longo prazo em vez de simplicidade na configuração inicial.Casos de uso do Pix com o Midaz
Veja como o Pix Switch e o Midaz trabalham juntos na prática:
Pix com Rotas de Transação
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.
Pix com tarifas automatizadas
Combine o Pix Switch com o Fee Engine para gestão de tarifas transparente e automatizada em fintechs e marketplaces.