Falha no Desembolso

Categoria: Desembolso
Evento: Falha no Desembolso

Nome do Evento

DISBURSEMENT_FAILED

Disparado quando o roteamento para a plataforma de crédito falha (FAILED_TO_ROUTE) ou o desembolso em si falha após o roteamento (DISBURSEMENT_FAILED).

Estrutura do Payload

{
  "eventType": "string",
  "entityId": "uuid",
  "occurredAt": "date-time",
  "data": {
    "id": "uuid",
    "externalContractId": "string",
    "status": "FAILED_TO_ROUTE | DISBURSEMENT_FAILED",
    "disbursementRequestedAt": "date-time",
    "updatedAt": "date-time"
  }
}

Tabela de Descrição dos Campos

Campo	Tipo	Descrição
`eventType`	string	Sempre `"DISBURSEMENT_FAILED"`.
`entityId`	uuid	ID interno da operação de crédito.
`occurredAt`	datetime	Momento em que a falha foi identificada (UTC).
`data.status`	enum	`FAILED_TO_ROUTE` (falha ao rotear para a plataforma de crédito) ou `DISBURSEMENT_FAILED` (falha no desembolso já roteado).
`data.disbursementRequestedAt`	datetime	Data e hora em que o desembolso havia sido solicitado.

Exemplo de Payload

Exemplo ilustrativo — construído a partir do schema CreditOperation, não extraído literalmente do OpenAPI. Validar com o time antes de publicar.

{
  "eventType": "DISBURSEMENT_FAILED",
  "entityId": "8f14e45f-ceea-467e-95b7-1c9f4e6d4a6b",
  "occurredAt": "2026-08-06T15:40:07Z",
  "data": {
    "id": "8f14e45f-ceea-467e-95b7-1c9f4e6d4a6b",
    "externalContractId": "ctr-98421",
    "status": "DISBURSEMENT_FAILED",
    "disbursementRequestedAt": "2026-08-06T15:10:00Z",
    "updatedAt": "2026-08-06T15:40:07Z"
  }
}

Próximos passos

Uma operação em FAILED_TO_ROUTE ou DISBURSEMENT_FAILED não é reprocessada automaticamente — trate como estado a investigar, e cancele via POST /credit-operations/{externalContractId}/cancel se não for reprocessável.