Excluir um código de desconto - Chargefy

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

{
  "id": "dcode_2rKmJ7zfueD2SDPz",
  "object": "discount_code",
  "deleted": true
}

{
  "id": "dcode_2rKmJ7zfueD2SDPz",
  "object": "discount_code",
  "code": "BLACK20",
  "created_at": "2026-05-21T12:00:00Z",
  "customer": null,
  "discount": "disc_dJj86WMARdBcAy96",
  "expires_at": null,
  "first_time_transaction": false,
  "is_active": false,
  "livemode": true,
  "max_redemptions": 500,
  "max_redemptions_per_customer": 1,
  "metadata": {},
  "minimum_amount": null,
  "minimum_amount_currency": null,
  "redemptions_count": 42,
  "updated_at": "2026-05-22T09:30:00Z",
  "valid": false
}

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

Parâmetros de caminho

string

required

ID do código (dcode_*).

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

Resposta

200 OK com um destes dois shapes:

Nunca foi aplicado (redemptions_count = 0) → o código é removido de verdade e a resposta traz o objeto curto com deleted: true.
Já teve redemption → o código é 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/discount-codes/:id.

{
  "id": "dcode_2rKmJ7zfueD2SDPz",
  "object": "discount_code",
  "deleted": true
}

{
  "id": "dcode_2rKmJ7zfueD2SDPz",
  "object": "discount_code",
  "code": "BLACK20",
  "created_at": "2026-05-21T12:00:00Z",
  "customer": null,
  "discount": "disc_dJj86WMARdBcAy96",
  "expires_at": null,
  "first_time_transaction": false,
  "is_active": false,
  "livemode": true,
  "max_redemptions": 500,
  "max_redemptions_per_customer": 1,
  "metadata": {},
  "minimum_amount": null,
  "minimum_amount_currency": null,
  "redemptions_count": 42,
  "updated_at": "2026-05-22T09:30:00Z",
  "valid": false
}

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

{
  "id": "dcode_2rKmJ7zfueD2SDPz",
  "object": "discount_code",
  "deleted": true
}

{
  "id": "dcode_2rKmJ7zfueD2SDPz",
  "object": "discount_code",
  "code": "BLACK20",
  "created_at": "2026-05-21T12:00:00Z",
  "customer": null,
  "discount": "disc_dJj86WMARdBcAy96",
  "expires_at": null,
  "first_time_transaction": false,
  "is_active": false,
  "livemode": true,
  "max_redemptions": 500,
  "max_redemptions_per_customer": 1,
  "metadata": {},
  "minimum_amount": null,
  "minimum_amount_currency": null,
  "redemptions_count": 42,
  "updated_at": "2026-05-22T09:30:00Z",
  "valid": false
}