> ## 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, QR BR Code, Pix Automático e disputas MED. O **Lerian SPI** é o conector de mensageria próprio da Lerian para o **SPI** (Sistema de Pagamentos Instantâneos). O SPI é a infraestrutura do Banco Central do Brasil (BACEN) que liquida o **Pix**, o sistema de pagamentos instantâneos do Brasil, 24 horas por dia. O Lerian SPI alcança o SPI e seu diretório de chaves (**DICT**) pela **RSFN**. A RSFN é a rede nacional privada para mensagens do sistema de pagamentos entre participantes e o BACEN. O Lerian SPI fala **ISO 20022** e não coloca nenhum parceiro de conectividade entre a instituição e o BACEN. O Lerian SPI dá a uma instituição participante um caminho direto ao BACEN. A instituição envia e recebe Pix, gerencia chaves Pix, emite cobranças por QR, executa autorizações recorrentes e trata disputas e devoluções. O trilho emite fatos de liquidação. Seu consumidor do ledger registra as posições correspondentes. ## Quem ele atende *** O Lerian SPI atende instituições financeiras que participam do Pix sob seu próprio **ISPB**. Cada participante se conecta direto ao BACEN, sem nenhum parceiro de conectividade no caminho do dinheiro. O trilho carrega os pagamentos, as chaves Pix, as cobranças e as disputas do participante em todas as superfícies abaixo. ## Quatro superfícies de API *** O Lerian SPI tem quatro superfícies de API. Em runtime, ele distribui quatro binários: `spi`, `dict`, `brcode` e `core`. As superfícies falam o contrato de mensageria de uma parte do ecossistema Pix. | Superfície | O que cobre | | -------------- | ----------------------------------------------------------------------------------------------------------------------------------------------- | | **Pagamentos** | Envio e recebimento de Pix, status e histórico de pagamentos, devoluções e autorizações recorrentes do Pix Automático | | **DICT** | O ciclo de vida da chave Pix, consultas e verificações de existência em lote, estatísticas antifraude e reivindicações de portabilidade e posse | | **BR Code** | Cobranças Pix — imediata (Cob), com vencimento (CobV) e em lote — e os payloads de QR EMV que resolvem a elas | | **Core & MED** | Registro e ciclo de vida do participante, disputas e devoluções do MED, e relatório de liquidação da Conta PI | ## A liquidação é em tempo real e assíncrona *** O SPI liquida cada Pix individualmente, em tempo real, a qualquer hora. Quando você envia um pagamento, a plataforma despacha uma mensagem de transferência de crédito ISO 20022 (`pacs.008`). A plataforma registra o pagamento como enviado ao BACEN, ainda não liquidado. O BACEN confirma a liquidação de forma assíncrona por meio de uma resposta de status (`pacs.002`). O trilho valida a resposta e move o pagamento para `COMPLETED` ou `REJECTED`. Cada pagamento carrega um **identificador fim a fim (E2EID)**. ## Neutralidade monetária *** O Lerian SPI é monetariamente neutro. Ele repassa os valores que você declara exatamente como declarados e não computa **nenhum** saldo ou posição próprios. O trilho carrega a mensagem e seu estado de liquidação. Seu consumidor do ledger registra a movimentação de dinheiro. ## Glossário *** | Termo | Significado | | --------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------- | | **Lerian SPI** | O trilho nativo Pix Direto da Lerian — uma integração direta com o BACEN pelo SPI. | | **Pix** | O sistema de pagamentos instantâneos do Brasil, operado pelo BACEN e que liquida 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 no sistema de pagamentos brasileiro. | | **Identificador fim a fim (E2EID)** | O identificador de 32 caracteres que rastreia um único pagamento Pix ao longo do trilho. | | **BR Code** | O padrão brasileiro de QR EMV (QRCPS-MPM) para o Pix, estático ou dinâmico. | | **Cob / CobV** | Uma cobrança Pix imediata (Cob) ou uma cobrança com vencimento, 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 do BACEN para disputas e devoluções por fraude ou erro. | | **Devolução** | Uma devolução Pix enviada de volta ao pagador contra um pagamento já liquidado. | | **Reivindicação (claim)** | Uma reivindicação de portabilidade ou de posse 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 o Pix pela RSFN. | | **Participante** | Uma instituição financeira conectada ao Pix, identificada pelo seu ISPB. | Para saber como o Lerian SPI se posiciona ao lado dos outros trilhos nativos e das interfaces de parceiros, veja [Mensageria nativa e interfaces de parceiros](/pt/rails/native-messaging).