Propostas e status

A proposta é criada quando o cliente escolhe uma oferta e envia os dados. Cada link tem no máximo uma proposta ativa.

CRIADAProposta criada no bancoproposta.criada
AGUARDANDO_FORMALIZACAOLink de assinatura geradoproposta.aguardando_formalizacao
FORMALIZADACliente assinouproposta.formalizada
APROVADABanco aprovouproposta.aprovada

Estados finais fora do caminho principal

RECUSADARecusada pelo banco (a partir de qualquer etapa ativa)proposta.recusada
CANCELADACancelada (a partir de qualquer etapa ativa)proposta.cancelada
FALHACriação recusada pelo banco; o cliente pode tentar novamenteproposta.falha

Regras de transição

O status só avança, nunca volta.
O banco pode pular etapas (por exemplo, de AGUARDANDO_FORMALIZACAO direto para APROVADA). Não há evento para uma etapa pulada.
RECUSADA e CANCELADA podem vir de qualquer etapa ativa e encerram a proposta.
FALHA indica que o banco recusou a criação da proposta. O cliente pode tentar novamente no mesmo link, com outra oferta ou outros dados.

Status	Evento	Final?
`CRIADA`	`proposta.criada`	não
`AGUARDANDO_FORMALIZACAO`	`proposta.aguardando_formalizacao`	não
`FORMALIZADA`	`proposta.formalizada`	não
`APROVADA`	`proposta.aprovada`	sim
`RECUSADA`	`proposta.recusada`	sim
`CANCELADA`	`proposta.cancelada`	sim
`FALHA`	`proposta.falha`	sim, para aquela tentativa

Acompanhar

Por webhook (recomendado): o Corban envia um evento a cada mudança de status. Veja Webhooks.

Por consulta: GET /v1/links/{id} traz o objeto proposta:

{
  "id": "fd6e64ed-5ebe-434d-9351-983ff129e9c0",
  "status": "EM_ANDAMENTO",
  "proposta": { "numero": 100004, "status": "AGUARDANDO_FORMALIZACAO", "criadaEm": "2026-10-14T18:12:40Z" }
}