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

StatusCodeMeaning
400BAD_REQUESTThe id is not a UUID.
401Missing or invalid API key.
403The key does not hold billing:write.
404NOT_FOUNDThe organisation is not in this key's scope.
404SUBSCRIPTION_NOT_FOUNDThe organisation has no live subscription.
409SUBSCRIPTION_NOT_CANCELLABLEThe 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.
502CHECKOUT_GATEWAY_REJECTEDStripe refused the request. Do not retry.
503CHECKOUT_UPSTREAM_ERRORfm-api could not reach Stripe, or Stripe rate-limited the call. Retry.
503CHECKOUT_NOT_CONFIGUREDThis deployment has no Stripe gateway.

Required scope: billing:write