> ## 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.

# ¿Qué es Lerian SPI?

> El conector directo y no intermediado de Lerian al BACEN para Pix: pagos instantáneos, directorio DICT, QR BR Code, Pix Automático y disputas MED.

**Lerian SPI** es el conector de mensajería propio de Lerian al **SPI** (Sistema de Pagamentos Instantâneos). El SPI es la infraestructura del Banco Central de Brasil (BACEN) que liquida **Pix**, el sistema de pagos instantáneos de Brasil, las 24 horas del día. Lerian SPI alcanza el SPI y su directorio de claves (**DICT**) a través de la **RSFN**. La RSFN es la red nacional privada para los mensajes del sistema de pagos entre los participantes y el BACEN. Lerian SPI habla **ISO 20022** y no pone ningún socio de conectividad entre la institución y el BACEN.

Lerian SPI le da a una institución participante una vía directa al BACEN. La institución envía y recibe Pix, gestiona claves Pix, emite cobros por QR, ejecuta autorizaciones recurrentes y tramita disputas y devoluciones. El riel emite hechos de liquidación; el consumidor de tu ledger registra las posiciones correspondientes.

## A quién sirve

***

Lerian SPI sirve a las instituciones financieras que participan en Pix con su propio **ISPB**. Cada participante se conecta directamente al BACEN, sin ningún socio de conectividad en la ruta del dinero. El riel transporta los pagos, las claves Pix, los cobros y las disputas del participante a través de cada superficie de abajo.

## Cuatro superficies de API

***

Lerian SPI tiene cuatro superficies de API. En tiempo de ejecución, se entrega como cuatro binarios: `spi`, `dict`, `brcode` y `core`. Las superficies hablan el contrato de mensajería de una parte del ecosistema Pix.

| Superficie     | Qué cubre                                                                                                                                                       |
| -------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Payments**   | Envío y recepción de Pix, estado e historial del pago, devoluciones y autorizaciones recurrentes de Pix Automático                                              |
| **DICT**       | El ciclo de vida de las claves Pix, búsquedas y verificaciones de existencia por lote, estadísticas antifraude y reivindicaciones de portabilidad y titularidad |
| **BR Code**    | Cobros Pix —inmediatos (Cob), con vencimiento (CobV) y por lote— y los payloads QR EMV que resuelven a ellos                                                    |
| **Core & MED** | Registro y ciclo de vida de participantes, disputas y devoluciones MED, y reporte de liquidación de la Conta PI                                                 |

## La liquidación es en tiempo real y asíncrona

***

El SPI liquida cada Pix individualmente, en tiempo real, sin interrupción. Cuando envías un pago, la plataforma despacha un mensaje ISO 20022 de transferencia de crédito (`pacs.008`). La plataforma registra el pago como enviado al BACEN, aún no liquidado. El BACEN confirma la liquidación de forma asíncrona mediante una respuesta de estado (`pacs.002`). El riel valida la respuesta y mueve el pago a `COMPLETED` o `REJECTED`. Cada pago lleva un **end-to-end ID (E2EID)**.

## Neutralidad respecto al dinero

***

Lerian SPI es neutral respecto al dinero por diseño. Reenvía los montos que declaras exactamente como los declaras y no calcula ningún saldo ni posición propia. El riel transporta el mensaje y su estado de liquidación; el consumidor de tu ledger registra el movimiento de dinero.

## Glosario

***

| Término                                                         | Significado                                                                                            |
| --------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------ |
| **Lerian SPI**                                                  | El riel Pix Direto nativo de Lerian —una integración directa con el BACEN sobre el SPI.                |
| **Pix**                                                         | El sistema de pagos instantáneos de Brasil, operado por el BACEN y liquidando 24/7.                    |
| **SPI** — Sistema de Pagamentos Instantâneos                    | La infraestructura de liquidación de pagos instantáneos del BACEN.                                     |
| **DICT** — Diretório de Identificadores de Contas Transacionais | El directorio de claves Pix del BACEN.                                                                 |
| **Clave Pix**                                                   | Un alias —teléfono, correo, identificación fiscal o EVP aleatorio— que resuelve a una cuenta.          |
| **ISPB**                                                        | Código de 8 dígitos que identifica a una institución participante del sistema de pagos brasileño.      |
| **End-to-end ID (E2EID)**                                       | El identificador de 32 caracteres que rastrea un único pago Pix a lo largo del riel.                   |
| **BR Code**                                                     | El estándar QR EMV de Brasil (QRCPS-MPM) para Pix, estático o dinámico.                                |
| **Cob / CobV**                                                  | Un cobro Pix inmediato (Cob) o un cobro con vencimiento con intereses y multa (CobV).                  |
| **Pix Automático**                                              | Autorizaciones Pix recurrentes y programadas —recorrência y agendamento.                               |
| **MED** — Mecanismo Especial de Devolución                      | El mecanismo de disputas y devoluciones del BACEN para fraude o error.                                 |
| **Devolução**                                                   | Una devolución Pix enviada de vuelta al pagador contra un pago liquidado.                              |
| **Reivindicação (reclamación)**                                 | Una reclamación de portabilidad o titularidad para mover una clave Pix entre participantes.            |
| **Conta PI**                                                    | La cuenta de liquidación de pagos instantáneos de un participante en el BACEN, reportada vía camt.05x. |
| **ISO 20022**                                                   | El estándar de mensajería (pacs / pain / camt) que el BACEN usa para Pix sobre la RSFN.                |
| **Participante**                                                | Una institución financiera conectada a Pix, identificada por su ISPB.                                  |

Para ver cómo Lerian SPI convive con los demás rieles nativos y las interfaces con socios, consulta [Mensajería nativa e interfaces con socios](/es/rails/native/native-messaging).
