Referência de status e webhooks CLT

Esta página resume os eventos e status usados no acompanhamento do fluxo de Crédito Privado CLT.

Cadastre a URL de retorno na página Webhooks usando o endpoint de webhook de consulta/margem:

POST /user/webhook/private-consignment/consult

Eventos de validação documentados:

Evento	Quando ocorre	Como tratar
`webhook.test`	Validação da URL cadastrada	Responder HTTP `2xx`
`webhook.registered`	Webhook registrado com sucesso	Registrar que a URL está pronta

A documentação atual apresenta os seguintes status:

Status	Uso no fluxo
`WAITING_CONSENT`	Aguardando aceite do cliente
`CONSENT_APPROVED`	Consentimento aprovado
`WAITING_CONSULT`	Aguardando consulta
`WAITING_CREDIT_ANALYSIS`	Aguardando análise de crédito
`SUCCESS`	Consulta concluída com sucesso
`FAILED`	Consulta encerrada com falha
`REJECTED`	Consulta rejeitada

Quando o status for SUCCESS, a margem retornada pode ser usada para seguir o fluxo de simulação.

Cadastre a URL de retorno usando:

POST /user/webhook/private-consignment/operation

Eventos documentados:

Evento	Quando ocorre	Como tratar
`private.consignment.operation.created`	Operação criada	Armazenar o ID e iniciar acompanhamento
`private.consignment.operation.updated`	Operação atualizada	Consultar detalhe quando precisar confirmar o estado completo

A listagem de operações CLT permite acompanhar status como:

Use esses status para atualizar a jornada do usuário e acionar rotinas de pendência, cancelamento ou conciliação.