Pular para o conteúdo principal
Construído na Plataforma Lerian — com integração nativa ao Midaz e uma arquitetura modular — o plugin abstrai a complexidade operacional, regulatória e de protocolo necessária para se conectar a um Participante Direto, reduzindo drasticamente o time-to-market para adoção do Pix.

O desafio para participantes indiretos


Instituições de Pix Indireto dependem de um Participante Direto para alcançar a infraestrutura Pix do BACEN. Este modelo reduz a sobrecarga regulatória, mas introduz um conjunto diferente de barreiras técnicas e operacionais:
  • middleware customizado para tradução de mensagens
  • fluxos de integração complexos com provedores diretos
  • requisitos rigorosos de orquestração
  • expectativas regulatórias em torno do DICT, fluxos de transação e prevenção de fraudes
  • infraestrutura de alta disponibilidade para processamento em tempo real
  • restrições de conformidade entre múltiplos atores
Combinados, esses fatores criam ciclos de integração que frequentemente levam meses, atrasando a prontidão para lançamento e aumentando o risco operacional.

A solução Lerian


O Plugin Pix Indireto fornece uma camada unificada de processamento entre os sistemas centrais do cliente e seu Participante Direto. Ele gerencia:
  • tradução de protocolo
  • roteamento de mensagens
  • orquestração de transações
  • fluxos relacionados ao DICT (validação de chave, consulta e sinalização de disputas)
  • conciliação e propagação de eventos
  • validações alinhadas com a regulação
As instituições implementam o Pix sem assumir a complexidade da rede em si. O resultado: Pix em semanas, não meses.

Principais benefícios


  • Integração Acelerada Elimina middleware customizado e reduz o esforço de integração em mais de 70%.
  • Integração Nativa com o Midaz Leituras do ledger em tempo real, validações de conta e lançamentos com zero mapeamento customizado.
  • Alinhado com o Ecossistema Lerian Conexões integradas com Reporter, Matcher, Flowker, Fee e Access Manager.
  • Conectividade com Provedor Direto Suporte nativo para APIs e tratamento de eventos de participantes diretos.
  • Conformidade Regulatória Workflows pré-configurados alinhados com as regras do BACEN para participantes indiretos.
  • Segurança e Observabilidade Empresarial Auditabilidade completa, trilhas de eventos, controle de acesso e garantias de resiliência.
  • Arquitetura Escalável Projetada para suportar operações Pix de alto volume e baixa latência.
O plugin se torna a espinha dorsal operacional para instituições que precisam do Pix, mas não da sobrecarga de gerenciar conectividade direta.

Arquitetura funcional


O Plugin Pix Indireto é composto por quatro módulos principais. Cada módulo implementa um domínio específico de operações Pix enquanto preserva coesão em todo o ciclo de vida do Pix.

Módulo DICT


Gerencia chaves Pix e workflows orientados pelo DICT.
  • API de Entradas – Registrar, atualizar, deletar e consultar chaves Pix em todos os formatos.
  • API e Eventos de Reivindicações – Ciclo de vida completo de portabilidade de entrada/saída com validação e notificações.
  • Worker de Resolução de Reivindicações – Processa janelas de reivindicação, timeouts e decisões.
  • Worker de Conciliação – Sincronização contínua do DICT com resolução automática de conflitos.
Garante que o estado do DICT permaneça consistente, auditável e em conformidade com os requisitos do BACEN.

Módulo QR Code


Suporte completo para geração, decodificação e orquestração de QR Code Pix.
  • API de QR Code Estático – Códigos de pagamento reutilizáveis.
  • API de QR Code Dinâmico Imediato – QR Codes de uso único, sensíveis ao tempo, com valores predefinidos.
  • API de QR Code Dinâmico com Vencimento – Pagamentos programados com datas de vencimento, descontos, multas e tarifas.
  • API de Decodificação – Analisa payloads e valida a estrutura do código.
Permite fluxos tanto de cobrança quanto de iniciação de pagamento.

Módulo de Transações


Motor principal de pagamentos para operações de saída, entrada e devolução.
  • API e Eventos de Cash-Out – Validação do ledger, autorização, execução e ciclo de vida do status.
  • Eventos de Cash-In – Processamento de Pix recebidos e atualização de saldos no ledger.
  • APIs de Devolução (Entrada/Saída) – Devoluções totais e parciais para ambas as direções.
  • Worker de Resiliência – Retentativa automática, recuperação e consistência eventual para operações pendentes.
Construído para orquestração de alto volume e tolerante a falhas.

Módulo MED (Disputas Regulatórias e Sinalização de Fraude)


Implementa workflows de disputa e sinalização de fraude mandatados pelo Banco Central, conforme definido pelo BACEN e aplicado por meio de processos relacionados ao DICT — não antifraude transacional em tempo real.
  • API e Eventos de Relatório de Infração – Enviar e rastrear relatórios de infração regulatórios vinculados a transações Pix, seguindo os workflows MED definidos pelo BACEN.
  • API e Eventos de Solicitação de Devolução (RDR) – Tratar solicitações de devolução relacionadas a fraude iniciadas sob regras do MED.
  • Worker de Análise Automática de Devolução – Automatiza a tomada de decisão para casos de MED e RDR com base em critérios regulatórios e cronogramas de evidências.
  • API de Sinalização Antifraude – Gerenciar marcadores de fraude, classificações e estatísticas para sinalização regulatória e resolução de disputas, não para bloqueio transacional.
Garante total conformidade com MED, RDR, sinalização de infração DICT e padrões de disputa do BACEN, mantendo auditabilidade e cronogramas regulados.

Integrações do ecossistema Lerian


Integrações nativas


  • Midaz Ledger Validação de saldo em tempo real, lançamentos em partida dobrada e roteamento de operações.
  • Plugin CRM Metadados de cliente e conta bancária para fluxos de orquestração Pix.
  • Fee Engine (opcional) Cálculo e lançamento automatizado de tarifas.
  • Access Manager (opcional) Identidade, credenciais e controle de acesso para aplicações Pix.

Integrações downstream


  • Reporter — Motor de relatórios regulatórios que consome eventos Pix para prestações ao BACEN.
  • Matcher — Conciliação multicamada entre ledger, estado do plugin e instruções do provedor.
  • Flowker — Motor de orquestração para fluxos customizados e regras de negócio.

Requisitos


Para operar como participante indireto usando o Plugin Pix Indireto, os clientes devem atender aos seguintes pré-requisitos:

Regulatórios e Contratuais


  • Ser uma instituição financeira ou de pagamento registrada como participante indireto no arranjo Pix.
  • Ter um contrato ativo com um Participante Direto conectado à plataforma Lerian.

Infraestrutura Técnica


  • Usar o Midaz como ledger principal.
  • Armazenar informações de clientes e contas no Plugin CRM.
  • Consumir APIs por meio do API Gateway da Lerian.
  • Manter versões compatíveis do Midaz, CRM e Plugin Pix.
  • Operar em infraestrutura cloud autogerenciada (BYOC) ou on-premise.

Próximos passos