> ## 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, el directorio de claves DICT, el QR BR Code, Pix Automático y disputas MED.

**Lerian SPI** es el conector de mensajería propio y no intermediado de Lerian al **SPI** (Sistema de Pagamentos Instantâneos), 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. Alcanza el SPI y su directorio de claves (**DICT**) a través de la **RSFN**, la red nacional privada que transporta los mensajes del sistema de pagos entre los participantes y el BACEN, usando mensajería **ISO 20022** sin ningún socio de conectividad entre la institución y el BACEN.

Le da a una institución participante una vía directa para enviar y recibir Pix, gestionar claves Pix, emitir cobros por QR, ejecutar autorizaciones recurrentes y tramitar disputas y devoluciones —todo directamente contra el BACEN, con cada posición registrada en **Midaz**, el ledger.

## A quién sirve

***

Lerian SPI sirve a las instituciones financieras que participan en Pix con su propio **ISPB**. Esos participantes envían y reciben pagos instantáneos, registran y resuelven claves Pix, emiten cobros inmediatos y con fecha de vencimiento como QR BR Code, ejecutan mandatos recurrentes de Pix Automático y abren y resuelven disputas MED —todo de forma directa, sin un socio de conectividad en la ruta del dinero.

## Cuatro superficies de API

***

El riel se organiza en cuatro superficies de API, y cada una habla el contrato de mensajería de una parte específica 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`) y devuelve un estado aceptado-pero-no-liquidado —el despacho fue aceptado, **no** que el BACEN lo haya liquidado—. El BACEN confirma de forma asíncrona mediante una respuesta de estado (`pacs.002`), que el riel valida y aplica para mover el pago a `settled` o `rejected`. Cada pago se rastrea por su **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. Toda posición contable vive en **Midaz**; Lerian SPI transporta el mensaje y su estado de liquidación, y Midaz registra el 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 de proveedor, consulta [Mensajería nativa](/es/rails/native/native-messaging).
