Excluir um desconto - Chargefy

curl -X DELETE "https://api.chargefy.io/v1/discounts/disc_LQqJsZEvbEsB2cv4" \
  -H "Authorization: Bearer {{API_KEY}}"

{
  "id": "disc_LQqJsZEvbEsB2cv4",
  "object": "discount",
  "deleted": true
}

{
  "id": "disc_LQqJsZEvbEsB2cv4",
  "object": "discount",
  "amount_off": null,
  "applies_to": {
    "products": []
  },
  "created_at": "2026-05-21T12:00:00Z",
  "currency": null,
  "duration": "once",
  "duration_in_months": null,
  "expires_at": null,
  "is_active": false,
  "livemode": true,
  "max_redemptions": null,
  "metadata": {},
  "name": "Black Friday 20%",
  "percent_off_basis_points": 2000,
  "redemptions_count": 42,
  "starts_at": null,
  "type": "percentage",
  "updated_at": "2026-05-22T09:30:00Z",
  "valid": false
}

Remove um discount sem redemptions. Quando já houve aplicação, o desconto é desativado com is_active=false e o objeto atualizado é retornado.

Parâmetros de caminho

string

required

ID do desconto (disc_*).

curl -X DELETE "https://api.chargefy.io/v1/discounts/disc_LQqJsZEvbEsB2cv4" \
  -H "Authorization: Bearer {{API_KEY}}"

Resposta

200 OK com um destes dois shapes:

Nunca foi aplicado (redemptions_count = 0) → o desconto é removido de verdade e a resposta traz o objeto curto com deleted: true.
Já teve redemption → o desconto é desativado (is_active=false, valid=false) para preservar o histórico das cobranças que o usaram, e a resposta traz o objeto completo atualizado — mesmo shape de GET /v1/discounts/:id.

{
  "id": "disc_LQqJsZEvbEsB2cv4",
  "object": "discount",
  "deleted": true
}

{
  "id": "disc_LQqJsZEvbEsB2cv4",
  "object": "discount",
  "amount_off": null,
  "applies_to": {
    "products": []
  },
  "created_at": "2026-05-21T12:00:00Z",
  "currency": null,
  "duration": "once",
  "duration_in_months": null,
  "expires_at": null,
  "is_active": false,
  "livemode": true,
  "max_redemptions": null,
  "metadata": {},
  "name": "Black Friday 20%",
  "percent_off_basis_points": 2000,
  "redemptions_count": 42,
  "starts_at": null,
  "type": "percentage",
  "updated_at": "2026-05-22T09:30:00Z",
  "valid": false
}

curl -X DELETE "https://api.chargefy.io/v1/discounts/disc_LQqJsZEvbEsB2cv4" \
  -H "Authorization: Bearer {{API_KEY}}"

{
  "id": "disc_LQqJsZEvbEsB2cv4",
  "object": "discount",
  "deleted": true
}

{
  "id": "disc_LQqJsZEvbEsB2cv4",
  "object": "discount",
  "amount_off": null,
  "applies_to": {
    "products": []
  },
  "created_at": "2026-05-21T12:00:00Z",
  "currency": null,
  "duration": "once",
  "duration_in_months": null,
  "expires_at": null,
  "is_active": false,
  "livemode": true,
  "max_redemptions": null,
  "metadata": {},
  "name": "Black Friday 20%",
  "percent_off_basis_points": 2000,
  "redemptions_count": 42,
  "starts_at": null,
  "type": "percentage",
  "updated_at": "2026-05-22T09:30:00Z",
  "valid": false
}