Pular para o conteúdo principal
O Lerian SLC opera sob duas restrições da SLC da Núclea: janelas de liquidação diárias rígidas e credenciais ICP-Brasil regulamentadas. O trilho aplica as janelas, assina por meio de um backend de custódia e oferece aos operadores endpoints para recuperar e conciliar operações.

​
Catálogo de participantes

O Lerian SLC mantém um catálogo dos participantes com os quais o tenant trabalha. O teste de conectividade e a leitura do status operacional retornam 404 para um participante fora do catálogo. O Lerian SLC ignora uma posição de compensação de um participante fora do catálogo.
  • Participantes. POST /v1/participants registra um participante. O tipo dele é ACQUIRER, SUBCREDITOR, DOMICILE_IF, SETTLEMENT_IF ou BRAND.
  • Arranjos. POST /v1/participants/{id}/arrangements registra um código de esquema de cartões sob o qual o participante opera. Ele também registra o papel do participante nesse esquema: ACQUIRER, ISSUER, BRAND, DOMICILE_IF ou SETTLEMENT_IF. Um segundo arranjo com o mesmo código e papel retorna 409.
  • Teste de conectividade. POST /v1/participants/{participantIspb}/test-connectivity envia uma sonda de conectividade à Núclea pelo canal REST. O caminho recebe o ISPB do participante, não o seu ID. A sonda é AGEN001 para um participante DOMICILE_IF e AGEN999 para os outros tipos. A resposta informa se a Núclea devolveu o eco da sonda intacto, e a latência de ida e volta.

​
Janelas de liquidação e grade horária

A SLC da Núclea liquida em janelas diárias rígidas definidas pela sua grade horária. O Lerian SLC avalia cada janela como OPEN, PRE_CUTOFF ou CLOSED, e condiciona o envio ao resultado. O trilho retém uma operação QUEUED fora da sua janela e a envia quando a janela abre. Isso evita a rejeição da Núclea por estar fora da janela (ESLC0029). O Lerian SLC emite schedule.cutoff_approaching quando uma janela se aproxima do seu corte, 30 minutos antes por padrão. Use GET /v1/schedule para ler as janelas e a janela de envio de crédito que o trilho aplica.
  • Enfileiramento e retransmissão. Uma operação permanece em CREATED até que um operador a reenfileire na fila de envio. Uma retransmissão submete de novo uma operação QUEUED.
O trilho também retém o envio e o encaminhamento de uma operação enquanto o status PAG0101 mais recente do seu credor for SUSPENDED ou SPECIAL_REGIME. Use GET /v1/participants/{id}/operational-status para ler esse status e se a retenção se aplica.

​
Certificados e custódia

O Lerian SLC delega a assinatura a um backend de custódia: uma chave de software, um PKCS#11 HSM ou o AWS KMS. A credencial de assinatura é um certificado ICP-Brasil com uma chave RSA de pelo menos 2048 bits.
  • Deploys SaaS travam a custódia no AWS KMS. O trilho importa o material de chave encapsulado do cliente e nunca recebe a chave privada de assinatura em texto claro.
  • Validade. O Lerian SLC se recusa a assinar com um certificado fora da sua janela de validade.
  • Rotação. O Lerian SLC lê o certificado de assinatura ativo em cada assinatura, então uma rotação tem efeito na próxima. O certificado de cliente mTLS é carregado na inicialização, então sua rotação exige uma reinicialização.
  • Alertas de vencimento escalam em 30, 15, 7 e 1 dia antes do vencimento, como eventos certificate.expiring, quando SCHEDULE_CERT_EXPIRY_ENABLED é true.

​
Contingência e recuperação

  • Filas de dead-letter. O trilho coloca em espera uma mensagem de entrada da RSFN ou do Lerian SILOC que não consegue processar. Uma mensagem em espera permanece na fila por 30 dias. GET /admin/dlq/{queue} lista as mensagens em espera, e uma reexecução reprocessa uma delas. A reexecução de uma mensagem já processada não altera nada.
  • Drenagens de recuperação. Os endpoints de envio, encaminhamento, nova consulta, repasse de status e reprocessamento reexecutam o próprio trabalho de saída e de retorno do trilho sem esperar a próxima execução do agendador.
  • Nova tentativa. Uma nova tentativa submete de novo uma operação REJECTED como uma nova operação vinculada à original. Uma operação que a IF Domicílio recusou em D+1, depois de liquidada, não aceita nova tentativa.
  • Operações em espera. Quando recusas consecutivas da contraparte esgotam o orçamento de tentativas de transmissão de uma operação de saída, o trilho coloca a operação em espera e emite um alerta em vez de tentar novamente para sempre. O endpoint de retomada a devolve ao backlog elegível, para que a próxima execução do agendador a reprocesse. Ele reinicia o contador de tentativas, então uma operação recuperada recebe um orçamento completo. Sem uma correção para a causa, ela volta a ficar em espera depois que esse orçamento se esgota.
  • Repasses de cancelamento. Quando o trilho não consegue determinar se um repasse de cancelamento à credenciadora chegou à Núclea, ele mantém o repasse bloqueado. Depois que você estabelece o resultado, o endpoint de resolução o registra: CONFIRMED mantém o repasse bloqueado, e ABANDONED permite repassá-lo de novo.
  • Depósitos com falha. GET /v1/funding/acks?result=FAILED lista os depósitos cuja falha a instituição informou.

​
Conciliação

  • Por operação. O trilho rastreia cada operação pelo seu NUliquid. Uma consulta por NUliquid lê o registro local. Se esse registro não existe, a consulta pergunta à Núclea. Isso exige o ISPB do participante e um NUliquid com no máximo 30 dias.
  • Com a Núclea. O endpoint de conciliação pede à Núclea o status de liquidação de uma operação (SLC0908) e registra a resposta. Ele move uma operação apenas de FORWARDED para CONFIRMED, e exige um motivo.
  • Por ciclo de compensação. O trilho rastreia a posição de compensação por ciclo e informa uma divergência bilateral. Ele sinaliza uma confirmação D+1 que também informa uma divergência no valor liquidado.