- Um Participante Direto, ou
- Um PSTI certificado + Gateway SPI contratado pela instituição.
1. O que o Plugin Pix fornece
O Plugin Pix entrega uma camada completa de orquestração Pix, gerenciando todo o ciclo de vida das operações Pix:
- Fluxos de cash-out e cash-in (orquestração pacs.008, 002 e 004)
- Pix Automático e jornada do pagador
- Transferências Pix intra-ledger (orquestração trck.002)
- Gestão de chaves Pix (lógica DICT + reivindicações)
- Geração de QR Code estático e dinâmico
- Orquestração do ciclo de vida do MED
- Webhooks, processamento de eventos, workers em background
- Integração completa com o Midaz (obrigatória para Pix Indireto e opcional, mas otimizada, para Pix Direto)
- BYOC (Bring Your Own Cloud)
- On-premise
2. Modelos de conexão
O Plugin Pix suporta todos os modelos de participação Pix definidos pelo BACEN — mas sempre por meio de um provedor de conectividade regulado.
Pix Indireto
Você se conecta ao Pix via infraestrutura de um Participante Direto. Ideal quando a instituição não mantém conectividade SPI/DICT.Pix Direto (via PSTI + Gateway)
Você opera o Pix diretamente, mas depende de um PSTI certificado + gateway SPI/DICT para comunicação com a rede do BACEN. Este modelo combina autonomia com conectividade regulada terceirizada.Pix Direto (completo)
Você mantém sua própria conectividade SPI/DICT e todos os canais regulados. Requer o mais alto nível de maturidade operacional e capacidade de infraestrutura.
3. Integrações no ecossistema Lerian
O Plugin Pix é agnóstico de ledger, mas oferece integração nativa e altamente otimizada com o Midaz como ledger principal. Isso simplifica:
- Validação de contas
- Verificação de saldos
- Lançamentos de débito/crédito
- Roteamento
- Aplicação de limites (apenas para Pix Direto)
- Conciliação (apenas para Pix Direto)
- Regras de negócio (tarifas, autorizações, gatilhos antifraude)
- Matcher — conciliação e correspondência de identidade
- Flowker — orquestração de workflows
- Reporter — relatórios regulatórios e prontos para COSIF
- Tracer — observabilidade e rastreamento distribuído
4. Público-alvo
O Plugin Pix é projetado para instituições que:
- Participam do arranjo Pix
- Mantêm seu próprio ledger (Midaz ou outro sistema)
- Controlam contas e saldos dos clientes
- Possuem um ISPB válido
- Gerenciam seus próprios ambientes de produção
- Preferem autonomia em vez de infraestrutura compartilhada no estilo BaaS
- Ambientes dedicados
- Processamento de alta performance
- Regras de negócio customizadas
- Arquitetura pronta para conformidade
- Menor dependência de PSPs externos
5. Requisitos para operar Pix com o Plugin
As instituições devem:
- Possuir um ISPB válido.
- Contratar um Participante Direto ou um PSTI + Gateway SPI que ofereça integração nativa com a infraestrutura Pix do BACEN, dependendo do modelo de participação.
- Operar seu próprio ambiente cloud/on-prem.
- Manter controle total do ledger.
- Ter prontidão de DevOps e SRE.
- Gerenciar sua própria segurança, redundância e observabilidade.
- Conectividade regulada (via PSTI ou Participante Direto)
- Continuidade operacional
- Conformidade e auditorias
- Provisionamento de infraestrutura
6. Vantagens de usar o Plugin Pix
As instituições se beneficiam de:
Controle total
- Execute tudo na sua infraestrutura
- Defina roteamento, regras, limites, políticas
- Sem ambientes compartilhados
Segurança e autonomia
- Suas próprias políticas de IAM e governança
- Isolamento completo do plano de dados e infraestrutura
Eficiência econômica
- Infraestrutura dimensionada para sua própria demanda
- Sem dependência de intermediários em múltiplas camadas
Integrações nativas ao ecossistema
- Midaz
- Matcher
- Flowker
- Reporter
- Tracer
Customização
- Estenda ou modifique a lógica de negócios conforme necessário
- Adapte-se a atualizações regulatórias no seu ritmo
7. Trade-offs e desafios
Embora o Plugin Pix ofereça máximo controle, ele vem com responsabilidades.
Requer maturidade técnica
As instituições precisam de capacidades de DevOps, observabilidade e gestão operacional.Requer disciplina de governança
Segurança, uptime e conformidade devem ser mantidos internamente.Mais configuração inicial
Flexibilidade significa mais orquestração e parametrização no início.Responsabilidade operacional
A instituição gerencia atualizações, patches e planos de continuidade. Este modelo é mais adequado para instituições que buscam autonomia, escalabilidade e otimização de custos a longo prazo.8. Como o Plugin Pix funciona dentro da arquitetura Lerian
Em todos os modelos de conexão, o plugin atua como o motor Pix dentro da sua infraestrutura:

- Ciclo de vida das transações
- Lógica do DICT
- Fluxos do MED
- Orquestração de devoluções
- Validações em tempo real
- Jobs em background
- Processamento de eventos
- Webhooks
- Lógica de conformidade
- Mensageria SPI
- Comunicação DICT
- Canais RSFN
- Infraestrutura criptográfica
- Conformidade em nível de rede

