Cancel Subscription
POST/subscriptions/:id/cancel
Cancels an active subscription, permanently stopping the billing cycle.
Cancellation Effects:
- The subscription status changes to
CANCELED
- No further charges will be processed
- Access to subscription services typically ends immediately or at period end (depending on your business rules)
Important Notes:
- Cancellation is permanent and cannot be undone
- To restart service, a new subscription must be created
- Consider using
pauseAtPeriodEnd
orcancelAtPeriodEnd
for softer transitions
Use this endpoint when a customer wishes to completely terminate their subscription.
Request
Responses
- 200
- 400
- 401
- 404
- 422
- 500
- 503
A subscription object
The request is incorrect or could not be processed
Unauthorized error. Please check your auth credentials
The specified resource was not found
The request was well-formed but could not be processed due to semantic errors
Unexpected server error
The service is temporarily unavailable