Pular para o conteúdo principal
O Lerian SLC é orientado a eventos nas suas bordas. Ele consome as mensagens de entrada da Nuclea e emite os seus fatos de negócio através de um outbox transacional para o backbone de streaming da plataforma e para webhooks assinados com HMAC, tudo em um envelope CloudEvents. Um evento é publicado apenas quando a sua mudança de estado foi confirmada.

O que ele consome


Da Nuclea, de entrada, sobre a RSFN:
  • GEN0015
  • SLC0001 — preview e final de clearing
  • SLC0002
  • PAG0101 — status operacional
Os retornos de arquivo —PRO / ERR / RET— são correlacionados de volta ao seu arquivo por nome de arquivo.

O que ele emite


Cada emissão passa pelo outbox transacional, de modo que um evento é publicado se e somente se a sua mudança de estado foi confirmada. Os eventos carregam um envelope CloudEvents e são entregues tanto no backbone de streaming quanto em webhooks assinados com HMAC.
  • Eventos de ciclo de vida da operação — um por transição de estado da operação.
  • operation.status_relayed — um status foi retransmitido.
  • cancellation.confirmed_by_domicile — um cancelamento confirmado pela IF Domicílio, que carrega o NUliquid.
  • d1.value_mismatch — uma divergência de valor D0-versus-D+1.
  • certificate.expiring — um certificado se aproximando do vencimento.
  • A família clearing.*cycle_opened, cycle_closed, cycle_recalculated, preview_available, final_available, credit_settled, credit_returned, deposit_required, deposit_deadline_approaching e divergence_reported.
Um webhook com chave NUliquid sinaliza o crédito ao estabelecimento e carrega a evidência do retorno do fluxo de domicílio.

Touchpoint com o Midaz


O Lerian SLC é standalone; ele não posta em um ledger por conta própria. O Midaz é um consumidor opcional —pode assinar os eventos do Lerian SLC ou chamar a sua API para espelhar a liquidação no ledger— mas o Lerian SLC não depende do Midaz.

Touchpoint com o Reporter


O Reporter é um consumidor opcional dos eventos do Lerian SLC, e também pode atuar como um provedor plugável opcional de materialização ASLC por meio de templates. A propriedade regulatória do layout ASLC permanece no Lerian SLC; o Reporter, quando plugado, apenas o renderiza.

Fronteira da rota do dinheiro


O Lerian SLC é dono da mensageria de liquidação de cartões com a Nuclea. Ele não realiza a liquidação monetária em si — a posição líquida liquida no SLC e na Nuclea, e a perna de reservas liquida no BACEN. A família de liquidação diferida líquida do domínio de cartões chega ao Lerian SLC retransmitida a partir do Lerian SILOC, a conectividade SILOC do lado do participante.

Convenções de API


  • Intake idempotente. Os envios pela API canônica são idempotentes por external_id, de modo que um envio repetido nunca liquida duas vezes.
  • Auth online. As operações individuais online sobre REST são protegidas com mTLS e uma assinatura JWS por requisição.
  • Os certificados são referências, não segredos. Um certificado registrado carrega o seu certificado público e uma referência de custódia; a chave privada nunca é armazenada nem devolvida.