Skip to main content
curl -X DELETE "https://api.chargefy.io/v1/subscriptions/sub_123" \
  -H "Authorization: Bearer {{API_KEY}}"

{
  "id": "sub_123",
  "object": "subscription",
  "billing_cycle_anchor": "2026-05-19T18:00:00Z",
  "billing_mode": {
    "type": "classic"
  },
  "cancel_at": null,
  "cancel_at_period_end": false,
  "canceled_at": "2026-05-20T12:00:00Z",
  "cancellation_details": {
    "comment": null,
    "feedback": null,
    "reason": "cancellation_requested"
  },
  "collection_method": "charge_automatically",
  "created_at": "2026-05-19T18:00:00Z",
  "currency": "brl",
  "current_period_end": "2026-06-19T18:00:00Z",
  "current_period_start": "2026-05-19T18:00:00Z",
  "customer": "cus_123",
  "days_until_due": null,
  "default_payment_method": "pm_123",
  "ended_at": null,
  "items": {
    "object": "list",
    "data": [],
    "has_more": false,
    "url": "/v1/subscription-items?subscription=sub_123"
  },
  "latest_invoice": "in_123",
  "livemode": true,
  "metadata": {},
  "next_billing_at": "2026-06-19T18:00:00Z",
  "pause_collection": null,
  "payment_settings": {},
  "pending_setup_intent": null,
  "pending_update": null,
  "start_date": "2026-05-19T18:00:00Z",
  "status": "canceled",
  "trial_end": null,
  "trial_settings": {
    "end_behavior": {
      "missing_payment_method": "create_invoice"
    }
  },
  "trial_start": null,
  "updated_at": "2026-05-20T12:00:00Z"
}
Cancela uma subscription imediatamente. Esse endpoint é a operação de remoção do recurso no contrato público: a assinatura sai de uso agora, mas a row permanece auditável para preservar histórico financeiro, invoices e webhooks. Depois do DELETE, a Chargefy atualiza a assinatura para status: "canceled", preenche canceled_at, remove qualquer cancelamento agendado, cancela jobs pendentes de trial/renovação e dispara subscription.canceled. A resposta retorna o objeto subscription completo atualizado. Por padrão, faturas que já estavam em aberto continuam open e cobráveis depois do cancelamento — o cancelamento não apaga o que o cliente já devia. Envie void_open_invoices: true para anular essas faturas no mesmo passo.
Se a intenção for cancelar somente no fim do período atual, use o endpoint de update com cancel_at_period_end: true. Para desfazer esse agendamento antes do corte, envie cancel_at_period_end: false no mesmo endpoint.
​
id
string
required
ID da subscription (sub_*).
​
cancellation_details
object
Detalhes opcionais do cancelamento. Aceita comment e feedback; reason é definido pela Chargefy.
​
void_open_invoices
boolean
default:"false"
Quando true, todas as faturas em aberto da assinatura passam para status: "void" e seus payment intents em aberto são cancelados. Por padrão (false), as faturas em aberto permanecem cobráveis após o cancelamento.
curl -X DELETE "https://api.chargefy.io/v1/subscriptions/sub_123" \
  -H "Authorization: Bearer {{API_KEY}}"

{
  "id": "sub_123",
  "object": "subscription",
  "billing_cycle_anchor": "2026-05-19T18:00:00Z",
  "billing_mode": {
    "type": "classic"
  },
  "cancel_at": null,
  "cancel_at_period_end": false,
  "canceled_at": "2026-05-20T12:00:00Z",
  "cancellation_details": {
    "comment": null,
    "feedback": null,
    "reason": "cancellation_requested"
  },
  "collection_method": "charge_automatically",
  "created_at": "2026-05-19T18:00:00Z",
  "currency": "brl",
  "current_period_end": "2026-06-19T18:00:00Z",
  "current_period_start": "2026-05-19T18:00:00Z",
  "customer": "cus_123",
  "days_until_due": null,
  "default_payment_method": "pm_123",
  "ended_at": null,
  "items": {
    "object": "list",
    "data": [],
    "has_more": false,
    "url": "/v1/subscription-items?subscription=sub_123"
  },
  "latest_invoice": "in_123",
  "livemode": true,
  "metadata": {},
  "next_billing_at": "2026-06-19T18:00:00Z",
  "pause_collection": null,
  "payment_settings": {},
  "pending_setup_intent": null,
  "pending_update": null,
  "start_date": "2026-05-19T18:00:00Z",
  "status": "canceled",
  "trial_end": null,
  "trial_settings": {
    "end_behavior": {
      "missing_payment_method": "create_invoice"
    }
  },
  "trial_start": null,
  "updated_at": "2026-05-20T12:00:00Z"
}

​
Webhooks

O cancelamento imediato dispara subscription.canceled com a subscription completa em data.object. Com void_open_invoices: true, cada fatura anulada dispara invoice.voided e cada payment intent cancelado dispara payment.intent.canceled, antes do subscription.canceled.