0
Votos
Cancelamento de cobrança via API V2
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.



Kauan - SWITCH postou esta ideia em 18/05/26 19:02