Pular para o conteúdo principal
O Lerian SPI é o conector de mensageria próprio e não intermediado da Lerian ao SPI (Sistema de Pagamentos Instantâneos), a infraestrutura do Banco Central do Brasil (BACEN) que liquida o Pix — o sistema de pagamentos instantâneos do Brasil — 24 horas por dia. Ele alcança o SPI e o seu diretório de chaves (DICT) pela RSFN, a rede nacional privada que transporta as mensagens do sistema de pagamentos entre os participantes e o BACEN, usando mensageria ISO 20022 sem nenhum parceiro de conectividade entre a instituição e o BACEN. Ele dá a uma instituição participante um caminho direto para enviar e receber Pix, gerenciar chaves Pix, emitir cobranças por QR, executar autorizações recorrentes e tratar disputas e devoluções — tudo diretamente contra o BACEN, com cada posição registrada no Midaz, o ledger.

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ícieO que cobre
PaymentsEnvio e recebimento de Pix, status e histórico do pagamento, devoluções e autorizações recorrentes de Pix Automático
DICTO 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 CodeCobranças Pix — imediatas (Cob), com vencimento (CobV) e em lote — e os payloads QR EMV que resolvem para elas
Core & MEDCadastro 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


TermoSignificado
Lerian SPIO trilho Pix Direto nativo da Lerian — uma integração direta com o BACEN sobre o SPI.
PixO sistema de pagamentos instantâneos do Brasil, operado pelo BACEN e liquidando 24/7.
SPI — Sistema de Pagamentos InstantâneosA infraestrutura de liquidação de pagamentos instantâneos do BACEN.
DICT — Diretório de Identificadores de Contas TransacionaisO diretório de chaves Pix do BACEN.
Chave PixUm alias — telefone, e-mail, CPF/CNPJ ou EVP aleatória — que resolve para uma conta.
ISPBCó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 CodeO padrão QR EMV do Brasil (QRCPS-MPM) para Pix, estático ou dinâmico.
Cob / CobVUma cobrança Pix imediata (Cob) ou uma cobrança com vencimento com juros e multa (CobV).
Pix AutomáticoAutorizações Pix recorrentes e agendadas — recorrência e agendamento.
MED — Mecanismo Especial de DevoluçãoO mecanismo de disputas e devoluções do BACEN para fraude ou erro.
DevoluçãoUma devolução Pix enviada de volta ao pagador contra um pagamento liquidado.
ReivindicaçãoUma reivindicação de portabilidade ou titularidade para mover uma chave Pix entre participantes.
Conta PIA conta de liquidação de pagamentos instantâneos de um participante no BACEN, reportada via camt.05x.
ISO 20022O padrão de mensageria (pacs / pain / camt) que o BACEN usa para Pix sobre a RSFN.
ParticipanteUma instituição financeira conectada ao Pix, identificada pelo seu ISPB.
Para ver como o Lerian SPI convive com os demais trilhos nativos e as interfaces de provedor, consulte Mensageria nativa.