Eventos de disputa (dispute.*)

Contestações abertas pelo devedor (ou registradas pelo operador). Abrir uma disputa pausa a régua da cobrança na hora. Em todos os eventos, data é a disputa completa.

Valores de type: already_paid · not_recognized · wrong_amount · service_not_provided · incorrect_invoice · wrong_recipient · other. Valores de status: open · under_review · resolved_valid · resolved_invalid · canceled. Valores de resolutionEffect: resume_rule · adjust_amount · cancel_charge · write_off.

dispute.created

Dispara na abertura da contestação (uma cobrança só pode ter uma disputa aberta por vez).

{
  "event": "dispute.created",
  "timestamp": "2026-07-23T12:00:00.000Z",
  "organization_id": "0f7a3c1e-2b4d-4e6f-8a9b-1c2d3e4f5a6b",
  "workspace_id": "5e8d1c4b-7a2f-4c9e-b3d6-0a1f2e3d4c5b",
  "data": {
    "id": "2c4e6a8b-1d3f-4a5c-8e7f-9b1d3f5a7c9e",
    "public_id": "e5f6a7b8-c9d0-4e1f-2a3b-4c5d6e7f8091",
    "organization_id": "0f7a3c1e-2b4d-4e6f-8a9b-1c2d3e4f5a6b",
    "workspace_id": "5e8d1c4b-7a2f-4c9e-b3d6-0a1f2e3d4c5b",
    "company_id": null,
    "business_unit_id": null,
    "charge_id": "4a2b6c8d-1e3f-4a5b-9c7d-2e4f6a8b0c1d",
    "person_id": "7c1e9f2a-3b4d-4c5e-8f6a-1b2c3d4e5f60",
    "type": "wrong_amount",
    "reason": "Valor divergente da proposta comercial",
    "disputed_amount": 350.00,
    "is_full_dispute": false,
    "documents": null,
    "status": "open",
    "assigned_to_id": null,
    "sla_due_at": "2026-07-30T12:00:00.000Z",
    "resolution": null,
    "resolution_effect": null,
    "resolved_by_id": null,
    "opened_at": "2026-07-23T12:00:00.000Z",
    "resolved_at": null,
    "deleted_at": null,
    "custom_metadata": null,
    "metadata": {},
    "external_id": null,
    "created_at": "2026-07-23T12:00:00.000Z",
    "updated_at": "2026-07-23T12:00:00.000Z"
  }
}

dispute.updated

Dispara quando a disputa entra em análise (status: "under_review", opcionalmente com assignedToId). Mesmo shape do dispute.created.

dispute.resolved

Dispara na decisão. Mesmo shape, com status resolved_valid (procedente) ou resolved_invalid (improcedente), resolution (texto), resolutionEffect, resolvedById e resolvedAt preenchidos. O efeito (retomar régua, ajustar valor, cancelar cobrança, dar baixa) já foi aplicado quando o evento chega.

dispute.cancelled

Dispara no cancelamento da disputa. Mesmo shape, com status: "canceled", resolution (motivo) e resolvedAt preenchidos.