Disputas

Contestações abertas pelo cliente sobre uma cobrança (já pagou, valor errado, não reconhece…). Não há delete: o fluxo anda por update, que executa uma ação — start_review, resolve ou cancel.

Comando	HTTP	Descrição
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}	Executar ação na disputa

Exemplos

--params carrega parâmetros de query, de caminho e de cabeçalho (id, página, filtros, X-Workspace-Id); --json carrega o corpo da requisição; --fields limita os campos que voltam — vale a pena em todo list/get, para economizar contexto. Veja Flags globais para a referência completa.

# Disputas abertas
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 a análise
kobana dunning disputes update \
  --params '{"id": "DISPUTE_ID"}' \
  --json '{"action": "start_review"}'

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

Próximos passos

• Negativações
• Introspecção de schema — todos os parâmetros que este recurso aceita.