Shared subscriptions

Shared subscription are supported using metadata on Stripe products and customers

For your app to support shared subscriptions you will have to implement the customer and subscriptions webhooks. Configure them here.

Configure Webhooks and Triggers

Shared subscription products

To make a product support shared subscription add on the product page the following metadata:

billing_supports_shared_subscriptions = true

You can see your list of active products on the Stripe dashboard.

This will ensure that users who subscribed to this product will be able to add/remove users to their subscriptions from their customer portal. They will be able to set users as managers of the shared subscription too.

Check that the metadata billing_supports_shared_subscriptionsdoes not contain any trailing whitespace as Stripe does not sanitize the metadata

Shared subscription owners

This is automatically set when the customer is using the Customer Portal

These instructions are only here to help you set up a shared subscription manually from the Stripe dashboard

A shared subscription always has an owner that can manage it from his customer portal

To manually set a Stripe customer as the owner of the subscription, add the following metadata to the subscription from the Stripe Dashboard

billing_shared_subscription_owner = cus_***

where cus_*** is the customer id of the owner

Shared subscription user/manager

This is automatically set when the customer is using the Customer Portal

These instructions are only here to help you add a user to an existing shared subscription manually from the Stripe dashboard

The owner of the shared subscription doesn't need this metadata

To manually set a Stripe customer as a user/manager of a shared subscription, add the following metadata to the customer who is sharing the subscription (not the owner) from the Stripe Dashboard

billing_shared_subscription_role = user or manager

A manager can add/remove users from the shared subscription just like the owner. There can be only one owner for a shared subscription.

A user can't edit the subscription

billing_shared_subscription_id = sub_***

Where sub_*** is the subscription id of the shared subscription.

This will ensure that the customer is on the shared subscription and this will consume one license from the shared subscription plan.

Please note that if you add more users to a shared subscription than the number of licenses on the subscription, the subscription won't be updated accordingly and the owner won't be charged more. You will have to update the shared subscription manually.