> ## Documentation Index > Fetch the complete documentation index at: https://docs.lerian.studio/llms.txt > Use this file to discover all available pages before exploring further. # O que é o Lerian SPI? > O conector direto e não intermediado da Lerian ao BACEN para o Pix — pagamentos instantâneos, o diretório de chaves DICT, o QR BR Code, o Pix Automático e as disputas MED. 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í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. | Para ver como o Lerian SPI convive com os demais trilhos nativos e as interfaces de provedor, consulte [Mensageria nativa](/pt/rails/native/native-messaging).