Skip to main content

​
Visão Geral

Este evento é disparado automaticamente pela Wincred quando uma proposta de e-consignado é cancelada por inatividade ou ao atingir um status terminal sem possibilidade de progressão. O sistema monitora constantemente o estado das propostas e aciona o cancelamento automático seguindo regras específicas de timeout e validação.
Importante: Cancelamentos manuais realizados via API não disparam este evento. Este webhook é exclusivo para cancelamentos automáticos do sistema.

​
Header do tipo do evento no Webhook:

x-event-type: e-consignado.contratacao-ativa.cancelamento

​
Estrutura do Evento

{
  "idContrato": "019a9cb2-257b-7610-aa32-834149c99bbc",
  "status": "CONTRATO_CANCELADO",
  "evento": "v1.e-consignado.contratacao-ativa.cancelamento",
  "dataCriacao": "2025-11-19T15:28:23Z"
}

​
Parâmetros

​
idContrato
UUID
required
Identificador único do contrato que foi cancelado no formato UUID
​
status
string
required
Status atual do contrato após o cancelamentoValor fixo: CONTRATO_CANCELADO
​
evento
string
required
Tipo do evento disparadoValor fixo: v1.e-consignado.contratacao-ativa.cancelamento
​
dataCriacao
string
required
Data e hora em que o evento de cancelamento foi gerado no formato ISO 8601 (UTC)

​
Regras de Cancelamento Automático

O sistema aplica duas categorias de regras para cancelamento automático de propostas:

​
Categoria 1: Cancelamento Imediato

Propostas são canceladas instantaneamente ao atingir os seguintes status terminais sem possibilidade de progressão:
Os dados bancários fornecidos são inválidos e todas as tentativas de correção foram esgotadas. O contrato não pode prosseguir.Quando ocorre: Após tentativas de validação dos dados bancários que resultaram em falha.Ação do sistema: Cancelamento imediato e automático da proposta.
A análise de Know Your Customer (KYC) foi concluída com rejeição. O cliente não passou nas verificações de segurança e conformidade.Quando ocorre: Após análise completa do processo de KYC que resultou em reprovação.Ação do sistema: Cancelamento imediato e automático da proposta.
O processo de averbação falhou e não foi possível registrar o contrato junto ao órgão pagador.Quando ocorre: Quando o sistema tenta averbar o contrato mas encontra falhas técnicas ou de processamento.Ação do sistema: Cancelamento imediato e automático da proposta.

​
Categoria 2: Cancelamento com Timeout

Propostas são canceladas às 01:00 do dia seguinte se permanecerem de um dia para o outro nos seguintes status de inatividade:
O contrato está aguardando que o cliente complete o processo de KYC. Se o cliente não concluir o preenchimento até o final do dia, o contrato é cancelado automaticamente.Quando ocorre: Aguardando ação do cliente para completar o formulário de KYC.Regra de timeout: Se permanecer neste status da criação até às 01:00 do dia seguinte, será cancelado automaticamente.Exemplo: Contrato criado às 21:30 do dia 15/05 → Cancelado às 01:00 do dia 16/05 se ainda estiver neste status.
O sistema está validando os dados bancários fornecidos. Se a validação não for concluída até o final do dia, o contrato é cancelado.Quando ocorre: Durante o processo automático de validação dos dados bancários.Regra de timeout: Se permanecer neste status da criação até às 01:00 do dia seguinte, será cancelado automaticamente.
O cliente excedeu o limite de 3 tentativas de correção dos dados bancários. Se nenhuma ação for tomada até o final do dia, o contrato é cancelado.Quando ocorre: Após o cliente tentar corrigir os dados bancários 3 vezes sem sucesso.Regra de timeout: Se permanecer neste status até às 01:00 do dia seguinte, será cancelado automaticamente.
Uma tentativa de correção dos dados bancários falhou. Se não houver nova correção até o final do dia, o contrato é cancelado.Quando ocorre: Após uma tentativa de correção dos dados bancários que falhou na validação.Regra de timeout: Se permanecer neste status até às 01:00 do dia seguinte, será cancelado automaticamente.Nota: Este status também pode resultar em cancelamento imediato se for a última tentativa permitida.
Janela de Timeout: A janela de cancelamento automático funciona das 00:00 às 23:59 do mesmo dia. Qualquer proposta que permaneça em um dos status de timeout durante essa janela será cancelada exatamente às 01:00 do dia seguinte.

​
Exemplos de Payload

Cancelamento
{
  "idContrato": "019a9cb2-257b-7610-aa32-834149c99bbc",
  "status": "CONTRATO_CANCELADO",
  "evento": "v1.e-consignado.contratacao-ativa.cancelamento",
  "dataCriacao": "2025-11-19T15:28:23Z"
}