Saltar al contenido principal
Lerian SLC es orientado a eventos en sus bordes. Consume los mensajes de entrada de Nuclea y emite sus hechos de negocio a través de un outbox transaccional hacia el backbone de streaming de la plataforma y hacia webhooks firmados con HMAC, todo en un envelope CloudEvents. Un evento se publica solo cuando su cambio de estado se ha confirmado.

Qué consume


De Nuclea, de entrada, sobre la RSFN:
  • GEN0015
  • SLC0001 — preview y final de clearing
  • SLC0002
  • PAG0101 — estado operativo
Los retornos de archivo —PRO / ERR / RET— se correlacionan de vuelta a su archivo por nombre de archivo.

Qué emite


Cada emisión pasa por el outbox transaccional, de modo que un evento se publica si y solo si su cambio de estado se confirmó. Los eventos llevan un envelope CloudEvents y se entregan tanto en el backbone de streaming como a webhooks firmados con HMAC.
  • Eventos de ciclo de vida de la operación — uno por transición de estado de la operación.
  • operation.status_relayed — se ha retransmitido un estado.
  • cancellation.confirmed_by_domicile — una cancelación confirmada por la IF Domicílio, que lleva el NUliquid.
  • d1.value_mismatch — una divergencia de valor D0-versus-D+1.
  • certificate.expiring — un certificado que se acerca a su vencimiento.
  • La familia clearing.*cycle_opened, cycle_closed, cycle_recalculated, preview_available, final_available, credit_settled, credit_returned, deposit_required, deposit_deadline_approaching y divergence_reported.
Un webhook con clave NUliquid señala el crédito al comercio y lleva la evidencia del retorno del flujo de domicilio.

Touchpoint con Midaz


Lerian SLC es standalone; no postea a un ledger por sí mismo. Midaz es un consumidor opcional —puede suscribirse a los eventos de Lerian SLC o llamar a su API para reflejar la liquidación en el ledger— pero Lerian SLC no depende de Midaz.

Touchpoint con Reporter


Reporter es un consumidor opcional de los eventos de Lerian SLC, y también puede actuar como un proveedor pluggable opcional de materialización ASLC mediante plantillas. La propiedad regulatoria del layout ASLC permanece en Lerian SLC; Reporter, cuando se conecta, solo lo renderiza.

Frontera de la ruta del dinero


Lerian SLC es dueño de la mensajería de liquidación de tarjetas con Nuclea. No realiza la liquidación monetaria en sí —la posición neteada se liquida en el SLC y en Nuclea, y la pierna de reservas se liquida en el BACEN. La familia de liquidación diferida neta del dominio de tarjetas llega a Lerian SLC retransmitida desde Lerian SILOC, la conectividad SILOC del lado del participante.

Convenciones de API


  • Intake idempotente. Los envíos por la API canónica son idempotentes por external_id, de modo que un envío reintentado nunca liquida dos veces.
  • Auth en línea. Las operaciones individuales en línea sobre REST se aseguran con mTLS y una firma JWS por solicitud.
  • Los certificados son referencias, no secretos. Un certificado registrado lleva su certificado público y una referencia de custodia; la clave privada nunca se almacena ni se devuelve.