SLC (Celcoin como Banco Liquidante)

Visão Geral

A Celcoin atua como Banco Liquidante, sendo responsável por executar a liquidação financeira das transações de cartões a partir das posições apuradas pela Núclea. Isso significa que:

  • Recebemos os valores a liquidar (créditos e débitos);
  • Processamos essas posições;
  • Efetivamos os lançamentos na sua conta de liquidação (conta proprietária);
  • Garantimos o repasse correto dos valores dentro dos prazos do arranjo.

Glossário

Liquidação: transferência efetiva de recursos entre instituições

Antecipação: recebimento antecipado de valores futuros

Conta proprietária: conta utilizada para liquidação

Ciclo de liquidação: momento em que os valores são processados


Liquidação de Transações (Débito e Crédito)

Esse fluxo corresponde à liquidação padrão das transações de cartão. Ele acontece em duas janelas diárias sendo: Manhã e Meio do dia;

Como funciona:

  1. A Celcoin recebe as posições de liquidação da Núclea;
  2. Cada transação é classificada como:
  • Crédito → valor a receber
  • Débito → valor a pagar
  1. Executamos os lançamentos:
  • Créditos (valores a receber): São creditados automaticamente na conta proprietária
  • Débitos (valores a pagar): São debitados da conta proprietária, desde que haja saldo disponível;

🚧

Saldo insuficiente

Se não houver saldo suficiente para débitos a liquidação não é realizada para aquelas transações e você será notificado. Os valores pendentes poderão ser reprocessados conforme regras do arranjo


👍

Confirmação da liquidação

Após o processamento, as liquidações efetivadas são confirmadas e você consegue validar por meio dos extratos valores liquidados


Liquidação de Antecipações

Esse fluxo trata das antecipações de recebíveis. Ele pode ocorrer ao longo do dia, dentro da janela operacional do arranjo.

Como funciona:

  1. A Celcoin recebe as instruções de antecipação
  2. Classificamos os lançamentos (crédito/débito):
  • Créditos (valores a receber): Valores de antecipação são creditados na conta proprietária
  • Débitos (valores a pagar): Valores de antecipação são debitados da conta proprietária, desde que haja saldo disponível;

🚧

Saldo insuficiente

Se não houver saldo suficiente para débitos a liquidação não é realizada para aquelas transações e você será notificado. Os valores pendentes poderão ser reprocessados conforme regras do arranjo.


👍

Confirmação da liquidação

Após o processamento, as liquidações efetivadas são confirmadas e você consegue validar por meio dos extratos valores liquidados.


Conta de Liquidação (Conta Proprietária)

  • A conta prorietária é utilizada para liquidação.
  • Responsabilidades do cliente:
    • Manter saldo suficiente para débitos
    • Acompanhar notificações de liquidação
    • Garantir conciliação dos valores

Webhooks de Erro de Liquidação

Durante o processamento das liquidações no SLC, a Celcoin enviará notificações de erro quando uma liquidação não puder ser efetivada.

Essas notificações têm como objetivo informar o cliente sobre pendências operacionais, principalmente relacionadas à insuficiência de saldo na conta de liquidação (conta bolsão).

Para receber os eventos de erro de liquidação, é necessário realizar previamente o cadastro do webhook por meio Webhook Manager.

Evento disponibilizado -entity: spb-event-error

O evento será disparado quando:

  • não houver saldo suficiente para efetivar uma liquidação;
  • a transação for recusada durante o processamento operacional do SLC.

Evento de erro – SLC0005 (Antecipação)

Esse evento ocorre quando uma liquidação de antecipação não é realizada por insuficiência de saldo.

Exemplo de webhook:

{
  "RequestBody": {
    "message": "Não houve a liquidação por falta de saldo no NumCtrlSLC: 20260420000047359076 e NumCtrlLTROr: 20260420300000037419 no valor de R$: 210,00"
  }
}

Evento de erro – SLC0001 (Liquidação padrão)

Esse evento ocorre quando uma liquidação padrão não é efetivada por insuficiência de saldo.

Exemplo de webhook:

{
  "RequestBody": {
    "message": "Não houve a liquidação por falta de saldo na Identificador Linha Bilateral: 20260420ECC0110032."
  }
}