Subscriptions API — Quickshops Headless REST API

The memberSessionId is the session ID from your member authentication system that links the portal request to the correct subscriber in Quickshops. This value identifies which subscriber’s billing portal to open — pass the session ID of the currently authenticated user.

Create billing portal session

Generates a Stripe billing portal URL for the subscriber identified by the given member session ID.

POST /subscription/portal

Body parameters

string

required

The session ID of the authenticated member whose subscription portal you want to open. This must correspond to an active subscriber on the store.

Request

curl -X POST https://api.quickshops.app/v1/subscription/portal \
  -H "Authorization: Bearer qk_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{ "memberSessionId": "sess_01j..." }'

Response

{
  "data": {
    "url": "https://billing.stripe.com/p/session/..."
  }
}

string

required

A Stripe billing portal URL. Redirect the subscriber’s browser to this URL so they can manage their subscription.

Redirecting the subscriber

Call this endpoint from your server-side handler using the authenticated subscriber’s session ID. Return the URL to your frontend to perform the redirect. Keep your API key on the server.

// Server-side only (API route, server action, or loader)
import { qs } from "@/lib/quickshops";

const { data } = await qs.subscription.subscriptionCreatePortalSession({
  memberSessionId: currentUser.sessionId,
});
const url = data.url;

// Return the URL to your frontend so it can redirect the subscriber
return { portalUrl: url };

Then in your client-side code, redirect using the URL returned from your server:

// Client-side — after receiving the URL from your server endpoint
window.location.href = portalUrl;

After the subscriber finishes in the portal, Stripe redirects them to the return URL configured in your Quickshops dashboard.

Get Started

Your Store

Products & Sales

Integrations

Developers

Subscriptions API — Quickshops Headless REST API

Create billing portal session

Body parameters

Request

Response

Redirecting the subscriber

​Create billing portal session

​Body parameters

​Request

​Response

​Redirecting the subscriber

Create billing portal session

Body parameters

Request

Response

Redirecting the subscriber