Saltar al contenido principal
Lerian SLC corre un único pipeline de liquidación para cada operación de tarjeta: toma una operación, construye el archivo ASLC para ella, la hace firmar bajo la custodia del cliente, la transmite a Nuclea y correlaciona los retornos —haciendo avanzar la operación a lo largo de su ciclo de vida por el NUliquid.

Intake


Las operaciones entran a Lerian SLC por dos modos canónicos:
  • API canónica — un intake REST/JSONL que transporta operaciones en la forma canónica de Lerian, idempotente por external_id, de modo que un envío reintentado nunca liquida dos veces.
  • XML ASLC directo — una carga de XML ASLC listo, para llamadores que ya lo producen.
Un modo de pass-through auditado también acepta artefactos prefirmados por el cliente y los reenvía bajo auditoría. Los tipos de operación son CREDIT, DEBIT, CANCELLATION, ANTICIPATION y SWEEP.

Construir, firmar, transmitir, correlacionar


Cada operación fluye por un único pipeline:
  1. Validar la operación contra los XSD de Nuclea.
  2. Construir el archivo ASLC — UTF-16BE, sin BOM, hasta 50.000 registros por archivo, con división automática cuando el conteo excede el límite.
  3. Firmar el archivo bajo la custodia del cliente (ver la orquestación de firma más abajo), luego aplicar GZIP y el SPB security envelope.
  4. Transmitir el archivo a Nuclea sobre REST, protegido por mTLS y una firma JWS por solicitud.
  5. Correlacionar los retornos de Nuclea —los retornos de archivo PRO / ERR / RET y el mensaje de estado ASLC028— de vuelta al archivo y a sus operaciones por nombre de archivo.

Familias de mensajes


FlujoFamilia de mensajes
Liquidación de créditoASLC027 / ASLC028
Liquidación de débitoASLC029 / ASLC030
AnticipaciónASLC031 / ASLC034
Retornos y devolucionesASLC041 / ASLC042 / ASLC043
CancelaciónASLC060–ASLC067
Domicílio de entradaASLC022 / ASLC023 / ASLC024 / ASLC025 / ASLC032 / ASLC033

Flujos de liquidación


  • Crédito (adquirente). Las operaciones entran por el intake canónico, Lerian SLC construye el archivo de crédito (ASLC027), lo firma y lo transmite, y correlaciona el estado ASLC028 y los retornos PRO/ERR/RET, haciendo avanzar cada operación por su ciclo de vida de NUliquid.
  • Débito y anticipación. El mismo pipeline de intake-construir-firmar-transmitir corre con las familias de débito (ASLC029 / ASLC030) y de anticipación (ASLC031 / ASLC034); los retornos de estado y el rastreo por NUliquid reflejan el flujo de crédito.
  • Cancelación. El adquirente informa una cancelación (crédito ASLC060, débito ASLC064); Lerian SLC la retransmite a la IF Domicílio (ASLC061), recibe el retorno de procesamiento del domicilio (ASLC062), devuelve el resultado al adquirente (ASLC063 / ASLC067) y emite un evento de cancelación-confirmada-por-domicilio que lleva el NUliquid.

IF Domicílio de entrada


Actuando como institución de domicilio, Lerian SLC recibe avisos de liquidación de crédito y débito (ASLC022 / ASLC024 / ASLC032), los confirma (ASLC023 / ASLC025 / ASLC033) y emite retornos y devoluciones (ASLC041 / ASLC042 / ASLC043). Un webhook con clave NUliquid señala el crédito al comercio y lleva la evidencia del retorno.

Clearing y fondeo para la IF Liquidante


Para la institución liquidante, Lerian SLC consume el preview y el final de clearing de entrada (SLC0001), el mensaje SLC0002 y el estado operativo (PAG0101) sobre la RSFN, construye la posición de clearing por ciclo de liquidación y detecta la divergencia de valor D0-versus-D+1. Levanta eventos de preview-disponible, final-disponible, depósito-requerido y plazo-de-depósito-por-vencer.

Ciclo de vida de la operación


Cada operación avanza por un ciclo de vida de 11 estados, rastreado por su NUliquid.
EstadoSignificado
CREATEDLa operación fue aceptada en Lerian SLC.
QUEUEDEstá en cola para la próxima construcción de archivo.
SENTSu archivo fue transmitido a Nuclea.
ACKNOWLEDGEDNuclea acusó recibo.
ACCEPTEDNuclea aceptó la operación.
REJECTEDNuclea rechazó la operación.
FORWARDEDEl aviso de liquidación fue reenviado a la IF Domicílio.
CONFIRMEDEl domicilio confirmó.
SETTLEDLa operación liquidó.
D1_CONFIRMEDLa liquidación está confirmada en D+1.
CANCELLEDLa operación fue cancelada.
Los archivos llevan su propio ciclo de vida de 10 estados, rastreado por archivo desde la construcción hasta la transmisión y la correlación de retornos.

Orquestación de firma


Lerian SLC materializa el XML ASLC sin firmar y luego delega la firma en un backend de custodia elegido por tenant. La clave privada nunca sale de la custodia del cliente, y Lerian nunca firma en nombre del cliente.
Backend de custodiaDónde vive la clave
Software keyUna clave en software en el entorno del cliente.
PKCS#11 HSMUn módulo de seguridad de hardware.
Cloud KMSUn servicio de gestión de claves en la nube.
VaultUn vault de secretos, por certificado.
En despliegues SaaS, la custodia se fija a cloud KMS vía importación de clave envuelta del lado del cliente: el cliente envuelve e importa su propia clave, y el servicio almacena solo el certificado público y una referencia de clave —nunca el material privado.

Transporte


Las operaciones y los archivos se envían a Nuclea sobre REST, protegidos por mTLS y una firma JWS por solicitud (la serie en línea SLC0908 / SLC0912 / SLC0915 / SLC0999). Los retornos de entrada se sondean y confirman sobre el mismo canal REST.