Pular para o conteúdo principal
Construído na Plataforma Lerian — com integração nativa ao Midaz e uma arquitetura modular — o plugin gerencia toda a conectividade necessária para participação direta no Pix, incluindo comunicação por meio da JD, o PSTI certificado responsável pelo acesso ao SPI e DICT. Isso reduz drasticamente a complexidade de implementação e acelera a adoção para instituições que possuem seu próprio ISPB.

O desafio para participantes diretos


Participantes diretos do Pix devem estabelecer e manter um link técnico com a infraestrutura de pagamentos instantâneos do BACEN (SPI e DICT). Essa conectividade é fornecida por meio de um PSTI certificado como a JD, que expõe as interfaces padronizadas exigidas pelo BACEN. Embora este modelo conceda total autonomia operacional, ele introduz responsabilidades técnicas e regulatórias significativas, incluindo:
  • Integração com as interfaces SPI/DICT da JD, seguindo requisitos rigorosos de estrutura de mensagem e assinatura
  • Gestão do ciclo de vida do DICT (registro de chaves, confirmação, exclusão, portabilidade e reivindicações de propriedade)
  • Orquestração de transações em tempo real com SLAs de menos de um segundo
  • Ingestão de webhooks e tratamento assíncrono de eventos
  • Aplicação de limites de transação com regras diurnas e noturnas
  • Geração de QR Code e decodificação conforme EMV
  • Conformidade com todas as regras Pix emitidas pelo BACEN
  • Processamento de alta disponibilidade com monitoramento 24/7
  • Alinhamento entre eventos da JD, liquidação do BACEN e lançamentos internos no ledger
Esses requisitos geralmente levam a ciclos de integração longos — frequentemente de 6 a 12 meses — quando implementados do zero.

A solução Lerian


O Plugin Pix Direto fornece uma camada unificada de processamento que abstrai a complexidade da conectividade direta do Pix. Ele se integra nativamente com a JD (um PSTI), gerenciando todas as interações com SPI e DICT em nome da sua instituição. O plugin gerencia:
  • Autenticação do protocolo JD, assinatura e formatação de mensagens
  • Ciclo de vida de entradas DICT (criação, confirmação, reivindicações, portabilidade, exclusão)
  • Transações: cash-in, cash-out, devoluções, estornos
  • Geração e decodificação de QR Code (estático, dinâmico imediato, dinâmico com vencimento)
  • Ingestão de webhooks da JD e lançamento automático no ledger
  • Validação de limites de transação (diário, noturno, mensal)
  • Consultas ao diretório para informações de participantes
  • Validação em tempo real para requisições de pagamento recebidas
  • Tratamento abrangente de erros alinhado com respostas da JD
Isso permite que as instituições implementem capacidades completas de Pix direto em semanas, não meses.

Principais benefícios


Conectividade Direta com o BACEN

Conectividade nativa ao SPI e DICT por meio da JD, eliminando esforço de implementação de protocolo e certificação.

Integração Acelerada

Sem necessidade de construir parsers de mensagem, camadas de assinatura, gerenciadores de token ou orquestradores DICT.

Integração Nativa com o Midaz

Verificações de saldo em tempo real, reservas, lançamentos e roteamento de operações — sem mapeamento customizado.

Alinhado com o Ecossistema Lerian

Conexões integradas com CRM, Reporter, Matcher, Flowker, Fee e Access Manager.

Gestão Completa do DICT

Ciclo de vida completo de chaves: criação, confirmação, portabilidade, reivindicações de propriedade e exclusão.

Operações de QR Code

Suporte para QR Codes EMV estáticos, dinâmicos imediatos e dinâmicos com vencimento.

Resiliência de Transações

Mecanismos de retentativa, workers de conciliação e workflows de consistência eventual.

Segurança e Observabilidade Empresarial

Trilhas de auditoria, logs estruturados, controle de acesso e rastreamento operacional completo.

Conformidade Regulatória

Workflows pré-configurados alinhados com os requisitos do BACEN para participantes diretos.

Arquitetura Escalável

Otimizada para operações Pix de alto volume e baixa latência com escalabilidade horizontal.

Arquitetura funcional


O Plugin Pix Direto é composto por cinco módulos principais, cada um gerenciando um domínio de operações Pix enquanto preserva coesão de ponta a ponta.

1. Módulo de Chaves PIX (Entradas)

  • Registrar, atualizar, deletar chaves
  • Confirmar chaves de telefone/e-mail
  • Rastrear status e confirmações pendentes
  • Recuperar informações do recebedor do DICT

2. Módulo de Reivindicações

  • Iniciar reivindicações de portabilidade ou propriedade
  • Receber, aprovar ou rejeitar reivindicações recebidas
  • Rastrear ciclo de vida e prazos das reivindicações

3. Módulo de QR Code

  • Gerar QR Codes estáticos e dinâmicos
  • Decodificar payloads EMV
  • Validar conformidade de formato
  • Vincular QR Codes aos fluxos de transação

4. Módulo de Transações

  • Pix de saída (cash-out)
  • Pix de entrada (cash-in)
  • Devoluções e devoluções parciais
  • Consulta e listagem de transações
  • Workers de resiliência e recuperação

5. Módulo de Limites

  • Configurar limites diários, noturnos e mensais
  • Cálculo de limite restante em tempo real
  • Resets automáticos por período

6. Módulo de Bancos e Participantes

  • Diretório de Participantes JD
  • Consulta de instituições por ISPB
  • Identificação do tipo de participante (direto/indireto)

Integrações do ecossistema Lerian


Integrações nativas

  • Midaz Ledger — lançamento e validação em tempo real
  • Plugin CRM — metadados de cliente e conta alias
  • Fee Engine — lógica automatizada de tarifas
  • Access Manager — OAuth2 e gestão de credenciais

Integrações downstream

  • Reporter — relatórios regulatórios
  • Matcher — conciliação multicamada
  • Flowker — orquestração de workflows

Requisitos para operar Pix Direto


Regulatórios

  • Deve ser um participante direto do Pix (ISPB próprio)
  • Deve operar por meio de um PSTI certificado (ex.: JD)
  • Deve manter certificados e credenciais SPI/DICT válidos

Técnicos

  • Midaz como ledger principal
  • CRM para gestão de titulares e contas alias
  • Acessibilidade ao API Gateway
  • Infraestrutura BYOC ou on-premise
  • Endpoints de webhook para ingestão de eventos da JD

Operacionais

  • Monitoramento 24/7
  • Processo de resposta a incidentes
  • Rotinas de conciliação
  • Suporte para disputas de chaves e transações
O Pix Direto está atualmente em desenvolvimento ativoVocê já pode explorar as APIs e capacidades em construção revisando a referência de API, que reflete o progresso e as decisões de design mais recentes.

Próximos passos