Hoje DELETE/PATCH/POST /charge/{id}/cancel na API V2 retornam 404. Quando uma
cobrança precisa ser cancelada (erro de cadastro, ajuste solicitado pelo cliente,
duplicidade, charge de teste, ou charge avulsa criada via API que ficou orfa de
boleto), o operador precisa cancelar manualmente no painel.
Proposta de endpoints:
- POST /charge/{id}/cancel body {"motivo": "erro_cadastro|ajuste_cliente|duplicidade|outro", "observacao": "texto opcional"}
Response: {"chargeId": N, "status": "cancelled", "cancelDate": "..."}
- Alternativa: PATCH /charge/{id} aceitando {"status": "cancelled"}
Benefícios - Fecha o ciclo de automacao end-to-end: empresas com agentes/integracoes que
criam cobrancas via API podem tambem cancelar quando preciso, sem fila manual.
- Elimina divergencia entre cancelamento "logico" no sistema do cliente e a
charge "Aberta" indefinidamente no Conexa.
- Melhora confiabilidade do indicador "cobrancas em aberto" no painel.
- Caso real Switch Hub: 3 charges de teste (114, 115, 126) em fila de cancelamento
manual ha dias. Em alto volume isso pode chegar a dezenas de pendencias/dia.