Pular para o conteúdo principal

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.

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.
O Pix Switch está em desenvolvimento ativo. A arquitetura e os contratos descritos nesta página refletem o design do produto. APIs e disponibilidade de provedores serão anunciados conforme estiverem prontos para produção.

​
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?. 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
  • 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
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.

​
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, 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.

​
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.

​
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.