Saltar al contenido principal
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.
SuperficieQué cubre
PaymentsEnvío y recepción de Pix, estado e historial del pago, devoluciones y autorizaciones recurrentes de Pix Automático
DICTEl 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 CodeCobros Pix —inmediatos (Cob), con vencimiento (CobV) y por lote— y los payloads QR EMV que resuelven a ellos
Core & MEDRegistro 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érminoSignificado
Lerian SPIEl riel Pix Direto nativo de Lerian —una integración directa con el BACEN sobre el SPI.
PixEl sistema de pagos instantáneos de Brasil, operado por el BACEN y liquidando 24/7.
SPI — Sistema de Pagamentos InstantâneosLa infraestructura de liquidación de pagos instantáneos del BACEN.
DICT — Diretório de Identificadores de Contas TransacionaisEl directorio de claves Pix del BACEN.
Clave PixUn alias —teléfono, correo, identificación fiscal o EVP aleatorio— que resuelve a una cuenta.
ISPBCó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 CodeEl estándar QR EMV de Brasil (QRCPS-MPM) para Pix, estático o dinámico.
Cob / CobVUn cobro Pix inmediato (Cob) o un cobro con vencimiento con intereses y multa (CobV).
Pix AutomáticoAutorizaciones Pix recurrentes y programadas —recorrência y agendamento.
MED — Mecanismo Especial de DevoluciónEl mecanismo de disputas y devoluciones del BACEN para fraude o error.
DevoluçãoUna 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 PILa cuenta de liquidación de pagos instantáneos de un participante en el BACEN, reportada vía camt.05x.
ISO 20022El estándar de mensajería (pacs / pain / camt) que el BACEN usa para Pix sobre la RSFN.
ParticipanteUna 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.