Canceling a Subscription
Cancellation Options
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.