> ## 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 con BACEN para Pix: pagos instantáneos, el directorio de claves DICT, códigos QR BR Code, Pix Automático y disputas MED.

**Lerian SPI** es el conector de mensajería propio de Lerian hacia el **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 llega al SPI y a 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 BACEN. Lerian SPI habla **ISO 20022** y no coloca ningún socio de conectividad entre la institución y BACEN.

Lerian SPI le da a una institución participante un camino directo hacia BACEN. La institución envía y recibe Pix, administra claves Pix, emite cobros con QR, ejecuta autorizaciones recurrentes y gestiona disputas y devoluciones. El riel emite hechos de liquidación. Tu consumidor de ledger registra las posiciones correspondientes.

## A quién sirve

***

Lerian SPI sirve a instituciones financieras que participan en Pix bajo su propio **ISPB**. Cada participante se conecta directamente con 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 en todas las superficies siguientes.

## Cuatro superficies de API

***

Lerian SPI tiene cuatro superficies de API. En tiempo de ejecución, distribuye 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 de pagos, devoluciones (devoluções) y autorizaciones recurrentes de Pix Automático                                                 |
| **DICT**       | El ciclo de vida de la clave Pix, búsquedas y verificaciones de existencia por lote, estadísticas antifraude, y reivindicaciones de portabilidad y titularidad (reivindicações) |
| **BR Code**    | Cobros Pix — inmediato (Cob), con vencimiento (CobV) y por lote — y los payloads EMV QR que se resuelven en ellos                                                               |
| **Core & MED** | Registro y ciclo de vida de participantes, disputas y devoluciones MED, y reporte de liquidación de Conta PI                                                                    |

## La liquidación es en tiempo real y asincrónica

***

El SPI liquida cada Pix de forma individual, 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 a BACEN, aún no liquidado. BACEN confirma la liquidación de forma asincrónica mediante una respuesta de estado (`pacs.002`). El riel valida la respuesta y mueve el pago a `COMPLETED` o `REJECTED`. Cada pago lleva un **ID de extremo a extremo (E2EID)**.

## Neutralidad monetaria

***

Lerian SPI es neutral frente al dinero. Reenvía los montos que declaras exactamente como los declaras y **no** calcula ningún saldo ni posición propios. El riel transporta el mensaje y su estado de liquidación. Tu consumidor de ledger registra el movimiento de dinero.

## Glosario

***

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

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