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