recoverSubscriptions

Recover a subscription through the Stripe Billing Portal. 🔐 This method requires authorization.

Description

This method restores a previously cancelled subscription for the current user through the Stripe Billing Portal. It returns a Promise that resolves to true if the recovery request was accepted, or an IError object if there was an issue.

⚠️ With the default errors.isShell: true setting, a rejected request is returned rather than thrown: this method resolves to an IError object, never to false. Check result === true - an error object is truthy, so if (result) would treat a failure as success.

Subscriptions.recoverSubscriptions(

body*

);

Parameters schema

Schema

body(required): ICancelSubscription
Subscription body
example:

{ marker: "premium" }

body.marker(required): string
Subscription marker.
example: "premium"

Examples

Minimal example

const response = await Subscriptions.recoverSubscriptions({ marker: 'premium' });

Example response

{
  "statusCode": 404,
  "timestamp": "2026-08-14T13:04:38.395Z",
  "message": "No subscription found"
}

Response schema

Details

Schema: boolean

boolean: boolean
Returns true if the recovery request was accepted.
example: true

---