Skip to main content
O Lerian SLC é orientado a eventos nas suas bordas. Ele consome as mensagens de entrada da Nuclea. Ele emite seus fatos de negócio por meio de um outbox transacional para o backbone de streaming da plataforma e para webhooks assinados com HMAC. Todo evento carrega um envelope CloudEvents. O Lerian SLC publica um evento apenas depois que sua mudança de estado é confirmada.

​
O que ele consome

Da entrada da Nuclea, pela RSFN:
  • GEN0015
  • SLC0001 (prévia e final da compensação)
  • SLC0002
  • PAG0101 (status operacional)
O Lerian SLC correlaciona cada costura de retorno pela chave que a contraparte ecoa: uma linha RET pelo seu número de controle de 20 posições, uma linha ASLC023 ou D+1 pelo seu NUliquid, e um PRO em nível de arquivo pelo número de controle do lote transmitido.

​
O que ele emite

Toda emissão passa pelo outbox transacional. O Lerian SLC publica um evento se e apenas se sua mudança de estado for confirmada. Cada evento carrega um envelope CloudEvents. A plataforma o entrega no backbone de streaming e para webhooks assinados com HMAC.
  • Eventos de ciclo de vida da operação: um por transição de estado da operação.
  • operation.status_relayed: o trilho repassou um status de operação para a IF Domicílio.
  • operation.forward_rejected: uma submissão de saída ficou em espera e precisa de ação do operador. O payload, não o nome do evento, informa qual perna e por quê. stage identifica a perna afetada: forward para a IF Domicílio ou dispatch para Núclea. Em ambos os casos, parkReason é attempt_budget_exhausted. Os ids de operação do payload são o que o endpoint de retomada recebe.
  • cancellation.confirmed_by_domicile: a IF Domicílio confirmou um cancelamento e o evento carrega o NUliquid.
  • d1.value_mismatch: uma divergência de valor entre D0 e 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.
Os webhooks do fluxo de domicílio carregam o NUliquid. Os consumidores o usam para correlacionar o crédito ao lojista de cada operação e sua evidência de retorno do domicílio.

​
Ponto de contato com o Midaz

O Lerian SLC é autônomo. Ele não lança no ledger por conta própria. O Midaz é um consumidor opcional. O Midaz pode se inscrever nos eventos do Lerian SLC ou chamar sua API para espelhar a liquidação no ledger. O Lerian SLC não depende do Midaz.

​
Ponto de contato com o Reporter

O Reporter é um consumidor opcional dos eventos do Lerian SLC. O Reporter também pode ser um provedor plugável opcional de materialização do ASLC por meio de templates. O Lerian SLC mantém a propriedade regulatória do layout do ASLC. O Reporter apenas o renderiza quando você o conecta.

​
Limite do caminho do dinheiro

O Lerian SLC detém a mensageria de liquidação de cartões com a Nuclea. Ele não faz a liquidação monetária em si. A posição líquida se liquida na SLC e na Nuclea. A perna de reserva se liquida no BACEN. A família de liquidação líquida diferida do domínio de cartões chega ao Lerian SLC repassada pelo Lerian SILOC, a conectividade SILOC do lado do participante.

​
Convenções de API

  • Ingestão idempotente. As submissões da API canônica são idempotentes por external_id. O Lerian SLC rejeita um external_id duplicado, então uma submissão reenviada nunca é liquidada duas vezes.
  • Autenticação online. mTLS e uma assinatura JWS por requisição protegem cada operação online individual via REST.
  • Certificados são referências, não segredos. Um certificado registrado carrega seu certificado público e uma referência de custódia. O Lerian SLC nunca armazena ou retorna a chave privada.