A quem atende
O Lerian SPI atende instituições financeiras que participam do Pix com o próprio ISPB. Esses participantes enviam e recebem pagamentos instantâneos, registram e resolvem chaves Pix, emitem cobranças imediatas e com vencimento como QR BR Code, executam mandatos recorrentes de Pix Automático e abrem e resolvem disputas MED — tudo de forma direta, sem um parceiro de conectividade no caminho do dinheiro.
Quatro superfícies de API
O trilho é organizado em quatro superfícies de API, e cada uma fala o contrato de mensageria de uma parte específica do ecossistema Pix.
| Superfície | O que cobre |
|---|---|
| Payments | Envio e recebimento de Pix, status e histórico do pagamento, devoluções e autorizações recorrentes de Pix Automático |
| DICT | O ciclo de vida das chaves Pix, buscas e verificações de existência em lote, estatísticas antifraude e reivindicações de portabilidade e titularidade |
| BR Code | Cobranças Pix — imediatas (Cob), com vencimento (CobV) e em lote — e os payloads QR EMV que resolvem para elas |
| Core & MED | Cadastro e ciclo de vida de participantes, disputas e devoluções MED, e reporte de liquidação da Conta PI |
A liquidação é em tempo real e assíncrona
O SPI liquida cada Pix individualmente, em tempo real, sem interrupção. Quando você envia um pagamento, a plataforma despacha uma mensagem ISO 20022 de transferência de crédito (
pacs.008) e retorna um estado aceito-mas-não-liquidado — o despacho foi aceito, não que o BACEN o tenha liquidado. O BACEN confirma de forma assíncrona por meio de uma resposta de status (pacs.002), que o trilho valida e aplica para mover o pagamento para settled ou rejected. Cada pagamento é rastreado pelo seu end-to-end ID (E2EID).
Neutralidade em relação ao dinheiro
O Lerian SPI é neutro em relação ao dinheiro por projeto. Ele repassa os valores que você declara exatamente como declarados e não calcula nenhum saldo ou posição própria. Toda posição contábil vive no Midaz; o Lerian SPI transporta a mensagem e o seu estado de liquidação, e o Midaz registra o dinheiro.
Glossário
| Termo | Significado |
|---|---|
| Lerian SPI | O trilho Pix Direto nativo da Lerian — uma integração direta com o BACEN sobre o SPI. |
| Pix | O sistema de pagamentos instantâneos do Brasil, operado pelo BACEN e liquidando 24/7. |
| SPI — Sistema de Pagamentos Instantâneos | A infraestrutura de liquidação de pagamentos instantâneos do BACEN. |
| DICT — Diretório de Identificadores de Contas Transacionais | O diretório de chaves Pix do BACEN. |
| Chave Pix | Um alias — telefone, e-mail, CPF/CNPJ ou EVP aleatória — que resolve para uma conta. |
| ISPB | Código de 8 dígitos que identifica uma instituição participante do sistema de pagamentos brasileiro. |
| End-to-end ID (E2EID) | O identificador de 32 caracteres que rastreia um único pagamento Pix ao longo do trilho. |
| BR Code | O padrão QR EMV do Brasil (QRCPS-MPM) para Pix, estático ou dinâmico. |
| Cob / CobV | Uma cobrança Pix imediata (Cob) ou uma cobrança com vencimento com juros e multa (CobV). |
| Pix Automático | Autorizações Pix recorrentes e agendadas — recorrência e agendamento. |
| MED — Mecanismo Especial de Devolução | O mecanismo de disputas e devoluções do BACEN para fraude ou erro. |
| Devolução | Uma devolução Pix enviada de volta ao pagador contra um pagamento liquidado. |
| Reivindicação | Uma reivindicação de portabilidade ou titularidade para mover uma chave Pix entre participantes. |
| Conta PI | A conta de liquidação de pagamentos instantâneos de um participante no BACEN, reportada via camt.05x. |
| ISO 20022 | O padrão de mensageria (pacs / pain / camt) que o BACEN usa para Pix sobre a RSFN. |
| Participante | Uma instituição financeira conectada ao Pix, identificada pelo seu ISPB. |

