Skip to main content
Lerian SPI es orientado a eventos. Las operaciones y los cambios de liquidación circulan como eventos de dominio en el backbone de streaming de la plataforma. Los sistemas downstream reaccionan a estos cambios sin hacer polling. El riel nativo no tiene consumidores de webhook expuestos al cliente. Su coordinación es interna a la plataforma.

​
Flujo de eventos

Cada contexto del riel publica y consume los eventos que le pertenecen:
  • El contexto BR Code publica los eventos de cobro y los eventos de la familia recurrente (Pix Automático). Consume spi.payment.settled para cerrar un cobro después de que su Pix se liquida y spi.mandate.resolved para sacar un mandato de Pix Automático de CRIADA.
  • El contexto Core consume eventos de confirmación de participante y eventos de finalización y terminación de liquidación. Mantiene el estado de participante y de operación alineado con BACEN.

​
Integración con el ledger

Lerian SPI no mantiene una posición contable propia. El riel emite eventos de liquidación en el backbone de streaming, y tu consumidor del ledger registra la posición correspondiente. El riel retransmite cada valor liquidado sin cambios. Cada evento de liquidación lleva un ce-id estable que identifica la liquidación. La entrega es al menos una vez, por lo que tu consumidor del ledger debe deduplicar las reentregas por ce-id.

​
Convenciones de API

  • La autenticación sigue el esquema estándar de Bearer token de la plataforma.
  • Los pagos llevan un end-to-end ID. Lees un pago y su historial por E2EID.
  • Las devoluciones son subrecursos. Creas y lees una devolução bajo el pago entrante padre que revierte. Debes solicitar una devolución dentro de los 90 días posteriores a la liquidación de ese pago. Una devolución no puede hacer que la suma de las devoluciones del Pix supere el valor del propio Pix. La contraparte emite una devolución de un Pix que tu cliente envió. Esa devolución llega como entrante.
  • Una devolución concluye con la respuesta de BACEN. Un pacs.004 que el riel despachó permanece en curso hasta que BACEN lo responde. Una solicitud duplicada de una devolución que ya está en curso recibe como respuesta que está en curso. Un identificador de devolución en conflicto recibe una respuesta de conflicto, nunca un recibo.
  • Los mensajes entrantes del riel se validan por firma. El riel no aplica un mensaje que falla la validación.