Skip to main content

Canceling a Subscription

Cancellation Options

Immediate vs. End-of-Period Cancellation

Immediate cancellation (cancel_at_period_end: false):
  • Status changes to CANCELED right away
  • A final prorated invoice is generated for usage up to the cancellation date
  • No future invoices
End-of-period cancellation (cancel_at_period_end: true):
  • Status remains ACTIVE until the period ends
  • canceled_at is set to the cancellation request time
  • Subscription proceeds normally until current_period_end
  • Cancels automatically after the last invoice

Deleting a Subscription

To permanently delete a subscription record:
Deleting a subscription is permanent and cannot be undone. Canceling is preferred — it preserves billing history while stopping future charges.