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.
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
The UI will look like this in the Customer Portal for subscripiton owners
With the ability to manage the users in their shared subscription by assigning and removing licenses
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.
Shared subscription users will see their current subscription as well as a button to contact their plan's owner
Last updated