DELETE/v1/charges/:id

Cancelar Cobrança

Cancela uma cobrança pendente no PSP. Só funciona para cobranças com status pending.

Atenção: Cobranças paid, expired ou cancelled não podem ser canceladas. Use o endpoint de busca para verificar o status atual antes de cancelar.

Exemplos

bash

curl https://api.hubpay.dev/v1/charges/chg_abc123 \
  -X DELETE \
  -H "Authorization: Bearer hpx_test_sua_chave"

Resposta 200

json

{
  "id": "chg_a1b2c3d4e5f6...",
  "object": "charge",
  "status": "cancelled",
  "amount": 5000,
  ...
}

Erros possíveis

Status	type	Quando
`401`	unauthorized	API key inválida
`404`	not_found	Cobrança não encontrada
`409`	invalid_state	Cobrança não está em status `pending`
`502`	psp_error	PSP retornou erro ao tentar cancelar