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

