Resume Subscription
Undo a pending cancellation, so the subscription renews as normal.
โถWhat this does
This call tells Stripe to renew the subscription at current_period_end.
Use it after DELETE /organizations/:id/subscription, before the period
ends. After the period ends the subscription is canceled, and this call
returns 404. Buy a new plan instead.
The response shows the new state at once.
โถCredits do not change
This call does not add credits, and it does not change the credit ledger or the plan allowance.
โถRepeat calls are safe
A call on a subscription that already renews returns 200 with the same
state.
โถErrors
| Status | Code | Meaning |
|---|---|---|
| 400 | BAD_REQUEST | The id is not a UUID. |
| 401 | Missing or invalid API key. | |
| 403 | The key does not hold billing:write. | |
| 404 | NOT_FOUND | The organisation is not in this key's scope. |
| 404 | SUBSCRIPTION_NOT_FOUND | The organisation has no live subscription. |
| 409 | SUBSCRIPTION_NOT_CANCELLABLE | The subscription is pending or incomplete, has no Stripe subscription yet, is a negotiated plan, or Stripe reports a status that is not live. details.status names it; a negotiated plan also carries details.plan_key. |
| 502 | CHECKOUT_GATEWAY_REJECTED | Stripe refused the request. Do not retry. |
| 503 | CHECKOUT_UPSTREAM_ERROR | fm-api could not reach Stripe, or Stripe rate-limited the call. Retry. |
| 503 | CHECKOUT_NOT_CONFIGURED | This deployment has no Stripe gateway. |
Required scope:
billing:write