> ## Documentation Index
> Fetch the complete documentation index at: https://docs.macropay.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# How to allow multiple subscriptions per customer

> Let one customer hold several active subscriptions at once — ideal for multi-product, multi-seat, and per-agent billing.

By default, a customer in Macropay can carry one active subscription at a time. That keeps billing simple for single-product businesses, but it gets in the way the moment a customer needs to subscribe to more than one thing — a second product line, an add-on plan, or a separate subscription per AI agent they deploy.

Flip one organization-level toggle and a customer can hold any number of concurrent subscriptions. Because Macropay is your [merchant of record](/features/usage-based-billing/introduction), every one of those subscriptions is invoiced, tax/VAT-remitted, and reconciled under the same flat fee — no extra plumbing on your side.

## When you'll want this

<CardGroup cols={2}>
  <Card title="Multiple products">
    A customer subscribes to your API plan *and* your analytics dashboard, each with its own renewal cycle.
  </Card>

  <Card title="Add-ons & seats">
    A base plan plus separately-billed add-ons, or a parallel seat-based subscription for the same account.
  </Card>

  <Card title="Per-agent billing">
    Each AI agent a customer spins up gets its own metered subscription, so usage and [agent ROI](/features/usage-based-billing/introduction) stay isolated per agent.
  </Card>

  <Card title="Team & sub-account plans">
    One billing customer fans out into several plans across the teams or environments they run.
  </Card>
</CardGroup>

## Turn it on

<Steps>
  <Step title="Open Organization Settings">
    In the Macropay dashboard, open **Settings** from the sidebar — or jump straight there:

    `https://macropay.ai/dashboard/${org_slug}/settings`

    Scroll to the **Subscriptions** section.

    <img height="200" src="https://mintcdn.com/macrodeepinc/rPF293t5zy_Onjx_/assets/guides/enable-multiple-subscription/settings.png?fit=max&auto=format&n=rPF293t5zy_Onjx_&q=85&s=203af2f300aa745680d202e3fd8e5ca9" data-path="assets/guides/enable-multiple-subscription/settings.png" />
  </Step>

  <Step title="Enable Allow multiple subscriptions">
    Switch **Allow multiple subscriptions** to **ON**. From now on, new checkouts can create a subscription for a customer even when they already have one active.

    <img height="200" src="https://mintcdn.com/macrodeepinc/rPF293t5zy_Onjx_/assets/guides/enable-multiple-subscription/enable-multiple-subs.png?fit=max&auto=format&n=rPF293t5zy_Onjx_&q=85&s=c3b41339fd5cc13fc6e94cd58c112b26" data-path="assets/guides/enable-multiple-subscription/enable-multiple-subs.png" />
  </Step>

  <Step title="Save">
    Click **Save** in the **Subscriptions** section to apply the change.

    <img height="200" src="https://mintcdn.com/macrodeepinc/rPF293t5zy_Onjx_/assets/guides/enable-multiple-subscription/save-enabled-multiple-subs.png?fit=max&auto=format&n=rPF293t5zy_Onjx_&q=85&s=fb41b6a5efa57e0b22d9d1228a4495d7" data-path="assets/guides/enable-multiple-subscription/save-enabled-multiple-subs.png" />
  </Step>
</Steps>

<Check>
  The setting takes effect immediately. Existing subscriptions are untouched; the change only governs whether *new* ones can stack onto a customer who is already subscribed.
</Check>

## What changes once it's on

| Behavior                                           | Toggle off (default)                | Toggle on                                       |
| -------------------------------------------------- | ----------------------------------- | ----------------------------------------------- |
| Second checkout for an already-subscribed customer | Blocked / replaces the current plan | Creates an additional, independent subscription |
| Billing cycles                                     | Single cycle per customer           | Each subscription bills on its own cadence      |
| Renewals & cancellations                           | One per customer                    | Managed per subscription                        |

<Note>
  Each subscription is its own object with its own status, billing interval, and line items. Cancelling, upgrading, or refunding one has no effect on the others.
</Note>

## Verify with the API

After enabling the toggle, a single customer can return several active subscriptions. List them by customer to confirm:

```bash theme={null}
curl -G "https://api.macropay.ai/v1/subscriptions" \
  -H "Authorization: Bearer $MACROPAY_API_KEY" \
  --data-urlencode "customer_id=cus_8f2k1a" \
  --data-urlencode "active=true"
```

A customer with two concurrent plans returns both:

```json theme={null}
{
  "items": [
    { "id": "sub_4d9...", "product_id": "prod_api_plan", "status": "active" },
    { "id": "sub_7c1...", "product_id": "prod_analytics", "status": "active" }
  ],
  "pagination": { "total_count": 2, "max_page": 1 }
}
```

<Tip>
  Pair this with the [customer portal](/features/customer-portal) so customers can self-manage each subscription — upgrade one, cancel another — without a support ticket.
</Tip>