Implementing Subscription Tiers with Moesif and Stripe

As we have seen in the last few years, subscription-based models align customer needs with business growth. Whether you’re a startup or an established enterprise, mastering the art of subscription tiers and learning how to apply them to your API monetization strategy is crucial. In this blog post, we will look at navigating through the implementation of subscription tiers for monetized APIs with the aid of two vital tools: Moesif and Stripe. By the end of this blog, you’ll be equipped to implement a subscription model that caters to your customer’s needs and scales with your business. Let’s begin by looking at what subscription tiers are.

What are subscription tiers?

Subscription tiers are the bread and butter of SaaS business models, especially regarding API monetization. They offer customers a choice of service levels, each with features and price points that suit their needs. This monetization model allows businesses to cater to a wide range of customers. Regarding subscription tiers within the API space, you’ll generally see companies offer a range of options that cover each user’s needs. For individuals or small businesses that may only need access to specific endpoints and low usage quotas, there may be an entry-level or free tier, up to large enterprises requiring full access and larger usage quotas. Once defined, tiers are strategically priced and packaged to encourage upgrades as customer needs evolve. By properly planning your tiers and pricing, you can quickly expand revenue as companies using your service also expand and require more from your service.

An example of API monetization tiers might look something like this:

Tier Name Endpoints Available Quota Limit Price
Bronze Basic Endpoints 1000 calls/month $100
Silver Basic + Intermediate Endpoints 100,000 calls/month $250/month
Gold All Endpoints 1,000,000 calls/month $1000/month

The table above showcases a tiered strategy where each ascending tier offers more endpoints and a higher quota limit, with the price reflecting the increased value. The ‘Starter’ tier serves as an entry point for users to test the API, while the ‘Enterprise’ tier is tailored for large-scale users who may need customized solutions and dedicated support.

What is Moesif?

Moesif is a platform designed to help businesses grow and monetize their API products. Moesif contains many key features that are relevant to API monetization, including:

  • Billing Meters: Set up usage-based Billing Meters on API calls and other metrics.
  • Billing Provider Integrations: Facilitate easy billing by directly integrating with leading providers or custom providers.
  • API Analytics: Real-time event logs to track and understand customer usage of APIs and apps.
  • Quotas & Governance: Manage API usage limits and enforce governance policies.
  • Developer Portal: An open-source portal for developers to subscribe and access monetized APIS.
  • Behavioral Cohorts and Emails: Understand user behaviors and send targeted communications based on subscription status, quota limits, etc.
  • Conversion Funnels: Optimize user onboarding and journeys to drive revenue and customer adoption.

Moesif’s monetization capabilities allow for the setup of metered billing, creating billing rules, and automating invoicing by integrating with billing providers. Overall, Moesif aims to help API providers effectively generate revenue from their APIs with an easy-to-use interface and features.

Implementing the subscription tiers

Implementing subscription tiers for API monetization is a multi-stage process that weaves together the functionalities of Stripe and Moesif. Below, we will set up an implementation that uses the prices defined in Stripe to enforce usage quotas in Moesif. This will require using Moesif’s Billing Meters and Governance Rules features. Let’s get started!

Note that the setup below will only work if you use a Moesif SDK or Plugin that supports governance. Please check the documentation to ensure that governance is supported in your setup.

#1 - Define the tiers in Stripe

First, we will create our subscription tiers in Stripe. To do so, perform the following steps in Stripe.

  1. Log into your Stripe Dashboard.
  2. In the left-side menu, click More and then select Product catalog
  3. On the Product catalog screen, click Add product in the top-right corner.
  4. On the Add a product screen, under Product information, enter your product’s name (such as “My API Product” and, optionally, a description.
  5. On the same screen, scroll down and under Price information do the following: select the Pricing model as “Standard pricing” set your Price for the tier and set it as “Recurring” Check off the Usage is metered checkbox and set the Charge for metered usage by dropdown to “Sum of usage values during period” Under Additional options, also give the price a name to match your tier’s name, such as “Bronze tier”, “Silver tier”, “Gold tier”, etc.
  6. Once the fields are complete, click the Add another price button and add your other tiers, repeating step 5 above.
  7. After all prices have been added, click Save product in the top right corner to save the product and prices.

After you’ve created your tiers, you should see that the Stripe Product catalog now contains your product and prices.

Stripe Product Catalog

#2 - Define the Billing Meter in Moesif

Now that we have our product and prices defined in Stripe, we must set up a Billing Meter for each tier we have created. To do so, we will perform the following steps:

  1. Log into Moesif.
  2. In the left-side menu, select Billing Meters.
  3. On the Billing Meters screen, click Add Billing Meter in the top-right corner.
  4. On the Add Billing Meter screen, give your Billing Meter a name to match the tier you are creating it for.
  5. Under Link to > Billing Provider, select “Stripe” from the dropdowns and the Product and Price corresponding to your tier.
  6. Then, set up a Filter that will outline which API calls you’d like to count towards the user’s usage ( See example below for specifics).
  7. Lastly, select the Metric that you would like to use, like “Event Count”, which will count every API call as a unit of usage.
  8. Repeat the steps above for each tier you’d like to implement.

Here’s an example of what this might look like.

Bronze Tier Moesif Setup

Note that the filter also includes the Stripe Price ID that corresponds to the tier the meter is for. For this, you’ll need to add a filter on the Company metadata like so: If the name of your price does not show up, carefully type it in to match the name you input in Stripe, as this will be case and whitespace-sensitive.

Once this is done, we will enforce the limits based on the tier the user has subscribed to with Moesif’s Governance Rule feature.

#3 - Define the Governance Rules in Moesif

To ensure customers stay within their subscription bounds, we will set up Governance Rules within Moesif. This requires two steps:

  1. Create the appropriate cohort for the users within a specific tier.
  2. Create the governance rule in Moesif to apply quota management to users within that cohort/tier.

To do these two things, we will need to do the following in Moesif:

  1. Navigate to the Quotas & Governance screen by clicking on the corresponding menu item in the left-side menu.
  2. On the Quotas & Governance screen, click the Add New button in the top-right corner of the screen and select Start from blank in the modal that appears.
  3. On the Add Governance Rule screen, we will select Create New Company Cohort in the Applicable Cohorts dropdown.
  4. For the company cohort input under Companies Where we will once again use the price identifier we used above ( as part of the filter. We will set this to match the tier that the cohort should be applied to.
  5. Next, we will set the Who Performed> Event Where criteria to match the filter we added in the Billing Meter (minus the Stripe Price filter since it was already added above in this case). We will also set the filter to At least “1000” times, or whatever the quota limit is for your tier.
  6. Lastly, we will set the Period selector to “Current Monthly Billing Period” and click Create Cohort in the bottom right.

An example of this can be seen below:

Quota Limit Reached

After the cohort is created, you’ll be brought back to the Create Governance Rule screen. Here, we will do the following:

First, add a name for the Governance Rule in the Name field. Next, ensure that the cohort for the tier is selected in the Applicable Company Cohorts dropdown. Also, ensure that the Apply to Companies in above Cohorts option is selected. Ensure that Blocking is set to true/checked off. Then, set the Override Response Status and Override Response Body to the values you would like to return when the user has reached their usage limit/quota. Click Create/Save Cohort to save the cohort.

Below is an example of what this might look like in practice.

Quota Reached Response

Ensure the Governance Rule is set to ON, or the quota will not be enforced.

Once you have implemented the above steps for each tier in your pricing scheme, you’ll be ready to launch your APIs. As each tier quota is met, Moesif will inform the SDK or Gateway (via the applicable Moesif plugin) to block traffic and return a custom response to the user. This ensures that users stay within their quota and protects upstream APIs from abuse.


Integrating Stripe and Moesif to manage subscription tiers is a strategic move that can significantly enhance your offering to your customers. By defining subscription tiers in Stripe and setting up Billing Meters and Governance Rules in Moesif, you can create a robust API monetization ecosystem that scales and maximizes revenue.

If the above setup is the missing piece you require for your API monetization strategy, contact the Moesif team today to discuss how our team of API monetization experts can help—looking to take Moesif for a spin first? You can also sign up for an account and get started in minutes. Let us help you get started with API monetization using Moesif and Stripe.

Learn More About Moesif Monetize API Products with Moesif 14 day free trial. No credit card required. Learn More
Monetize Your API Products Monetize Your API Products

Monetize Your API Products

Learn More