Disputas

Impugnaciones que el cliente abre sobre un cobro (ya pagó, monto incorrecto, no lo reconoce…). No hay delete: el flujo avanza con update, que ejecuta una acción — start_review, resolve o cancel.

Comando	HTTP	Descripción
disputes list	GET /v1/disputes	Listar disputas
disputes create	POST /v1/disputes	Abrir disputa
disputes get	GET /v1/disputes/{id}	Consultar disputa
disputes update	PATCH /v1/disputes/{id}	Ejecutar acción en la disputa

Ejemplos

--params lleva parámetros de query, de ruta y de encabezado (id, página, filtros, X-Workspace-Id); --json lleva el cuerpo de la solicitud; --fields limita los campos que vuelven — vale la pena en todo list/get, para ahorrar contexto. Mira Flags globales para la referencia completa.

# Disputas abiertas
kobana dunning disputes list --params '{"status": "open"}'

# Abrir disputa
kobana dunning disputes create \
  --json '{"charge_id": "CHARGE_ID", "type": "already_paid", "reason": "Pago via Pix em 02/08"}'

# Iniciar el análisis
kobana dunning disputes update \
  --params '{"id": "DISPUTE_ID"}' \
  --json '{"action": "start_review"}'

# Resolver como procedente y cancelar el cobro
kobana dunning disputes update \
  --params '{"id": "DISPUTE_ID"}' \
  --json '{"action": "resolve", "decision": "valid", "resolution": "Pagamento confirmado", "effect": "cancel_charge"}' --dry-run

Próximos pasos

• Negativaciones
• Introspección de schema — todos los parámetros que acepta este recurso.