Skip to main content
Pix Direto via JD é o caminho de conectividade para participantes diretos no Pix. A infraestrutura regulada da JD conecta a sua instituição ao SPI e ao DICT do BACEN. A sua instituição é dona da própria participação no Pix. A JD fornece a conectividade certificada que alcança a rede do BACEN. A integração de Pix da Lerian abstrai o provedor de conectividade atrás de uma única API. A mesma documentação de Pix se aplica a todos os provedores:
  • O que é Pix? — o trilho em si: modalidades, SPI, DICT e modelos de participação.
  • Pix Switch — a camada de orquestração que trata gestão do DICT, transações, QR Codes e MED por meio de uma única API.
  • Casos de uso de plugins — cenários de ponta a ponta que combinam Pix com tarifas, rotas de transação e o ledger.

​
Como as movimentações Pix chegam ao Midaz

O plugin de participação direta registra cada movimentação Pix liquidada — cash-out, cash-in, devoluções, as pernas de efetivação do MED e a liquidação do Pix Automático — no Midaz como uma transação de ledger, com a perna externa contra a conta de clearing (por exemplo, @external/BRL). O Midaz guarda o lançamento contábil; a identidade do pagador e do recebedor (banco, agência, conta, nome e documento do titular, chave Pix) e todas as referências BACEN ficam apenas no registro de transação do próprio plugin. A correlação entre os dois sistemas funciona por identificadores, não por metadados:
  • O end-to-end ID (E2E) é a chave de idempotência do lançamento no Midaz, então uma liquidação reexecutada nunca duplica o lançamento no ledger. As pernas subsequentes do mesmo E2E — uma devolução ou uma efetivação de MED — derivam a chave do E2E com um sufixo de fluxo, então nunca colidem com o lançamento original.
  • O plugin armazena o id do lançamento Midaz no próprio registro de transação, e o usa para confirmar ou cancelar o débito pendente de um cash-out em duas fases.
Para ver o detalhe bancário por trás de um lançamento do ledger, consulte a API de transações do plugin pelo id da transação do plugin ou pelo E2E ID. A transação Midaz em si não carrega dados de contraparte nem metadados personalizados — por design, o ledger permanece contabilidade pura.
A Lerian provisiona a configuração específica do provedor para participação direta via JD com a sua integração. Para configurar a participação direta no Pix, fale com o nosso time.