Pular para o conteúdo principal
O Pix Lerian é a interface que conecta o Midaz ao Lerian SPI, a mensageria Pix própria da Lerian. Ele expõe APIs DICT, SPI, COB e Pix Automático e registra no Midaz a movimentação financeira necessária para cada fluxo compatível.

​
O que o plugin faz

  • DICT: gerenciar chaves Pix, reivindicações, casos de MED 2.0, marcadores de fraude e conciliação do VSync.
  • SPI: iniciar saques, processar pagamentos, agendar pagamentos, receber callbacks do adaptador, criar devoluções e gerenciar retenções de saldo do MED 2.0.
  • COB: criar BR Codes estáticos e cobranças imediatas e com vencimento.
  • Pix Automático: decidir solicitações de autorização de pagamentos recorrentes pelo pagador, gerenciar autorizações e cancelar débitos agendados.
  • Integração com o Midaz: validar o contexto da conta e criar o débito, crédito, retenção, liberação ou estorno exigido pelo fluxo.
Comece por Integrar com o Pix Lerian e depois use os guias funcionais de DICT, SPI, COB e Pix Automático.

​
Plugin, adaptador e trilho

O plugin é a camada de aplicação. Ele mantém o estado local das operações e chama o Midaz para o trabalho contábil. Ele chama um adaptador de conectividade para o lado do provedor. O adaptador envia callbacks assíncronos ao plugin. O adaptador de conectividade Lerian chama o Lerian SPI. O provedor simulado fornecido simula o lado do provedor para testes de integração. Não use o mock como evidência de que um provedor de produção ou a participação direta estão certificados ou habilitados.

​
Quem usa o Pix Lerian

O Pix Lerian é uma interface para instituições que controlam o próprio ledger e as próprias regras de conta. Ele não é um PSP nem um PSTI. A instituição continua responsável pela sua participação regulatória e pelo seu arranjo de conectividade. O Midaz é obrigatório para a validação de contas e os efeitos contábeis do plugin. O plugin coordena a operação Pix e registra o débito, crédito, retenção, liberação ou estorno correspondente por meio do Midaz. O plugin não substitui o ledger da instituição.

​
Modelo de deploy

Faça o deploy do Pix Lerian no ambiente BYOC da instituição e opere as dependências nesse ambiente. Sua equipe é responsável pelo deploy, pela observabilidade, pelo controle de acesso e pela continuidade.

​
Escolha um caminho funcional

​
Referência da API

Use a referência gerada para consultar os schemas de requisição e resposta: Os guias funcionais explicam o sequenciamento e a responsabilidade. A referência da API continua sendo o contrato para a validação de campos e as respostas de cada operação.