Working with multiple subscriptions

Create multiple subscriptions for a single customer by subscribing them to more than one product or different price of the same product.

You can now model subscriptions more flexibly using the Prices API. It replaces the Plans API and is backward compatible to simplify your migration. If you’re new to Stripe, learn how to create products and prices. If you already use the Plans API, learn how to update your integration.

Stripe offers the ability to simultaneously create multiple subscriptions on a single customer. This capability is useful when you want to make it possible for your customers to subscribe to multiple products with separate intervals. Each subscription has its own separate billing cycle, invoice, and charge—even if the underlying prices have the same billing interval.

If you want to create multiple subscriptions for a customer with a single billing cycle and invoice, you can combine multiple products in one subscription instead of using multiple subscriptions.

Create multiple subscriptions on a customer by using the same create subscription code:

Terminal

curl https://api.stripe.com/v1/subscriptions \
  -u sk_test_4eC39HqLyjWDarjtT1zdp7dc
: \
  -d "customer"="cus_4fdAW5ftNQow1a" \
  -d "items[0][price]"="price_CZB2krKbBDOkTS"
curl https://api.stripe.com/v1/subscriptions \
  -u sk_test_4eC39HqLyjWDarjtT1zdp7dc
: \
  -d "customer"="cus_4fdAW5ftNQow1a" \
  -d "items[0][price]"="price_CZB1AX3KOacNJw"

A customer can be subscribed to multiple products or even to a single product multiple times. Each subscription has a unique ID and its state is handled independently from the customer’s other subscriptions. Each subscription also has its own independent billing cycle, based on the billing cycle anchor of the subscription.

When a customer has multiple subscriptions, the Customer object’s subscriptions property provides a list of every subscription:

{
  "id": "cus_4fdAW5ftNQow1a",
  "object": "customer",
  "subscriptions": {
    "object": "list",
    "data": [
      {
        "id": "sub_9RRl3XywPg2P5H",
        "object": "subscription",
        ...
        "price": {
          "id": "price_CZB2krKbBDOkTS",
          "object": "price",
          "amount": 2995,
          ...
        }
      },
      {
        "id": "sub_9RRlIq2t9obFLI",
        "object": "subscription",
        ...
        "price": {
          "id": "price_CZB1AX3KOacNJw",
          "object": "price",
          "amount": 1295,
          ...
        }
      },
    ]
    ...
  }
  ...
}

Working with multiple subscriptions

See also