Flex billing

Mantle’s Flex Billing transforms how you handle recurring charges for tiered pricing structures by automating plan upgrades based on customer usage. This solves a common challenge with traditional subscription models where customers need to manually upgrade when they hit usage limits.

Understanding flex billing

In traditional subscription models:

• Customers must manually upgrade when they hit usage limits
• This requires multiple steps and approvals
• Service often gets interrupted while waiting for upgrades
• Apps must decide whether to stop service, wait for upgrades, or absorb costs

Flex billing solves these challenges by:

• Using usage charges to simulate recurring subscriptions
• Enabling automatic upgrades without manual intervention
• Allowing usage to continue seamlessly from where it left off
• Maintaining clear communication about changes

Key benefits

1. Automatic plan upgrades

   • Customers automatically move to higher tiers when usage thresholds are met
   • No manual intervention required
   • Clear customer communication about changes

2. Continuous usage tracking

   • Usage doesn’t reset monthly
   • Smooth transitions between billing cycles
   • No interruption in service

3. Flexible billing

   • Multiple plans under the same usage charge approval
   • Automatic upgrades as thresholds are reached
   • Simple administration

4. Seamless billing experience

   • Customers remain on upgraded plans for next cycle
   • No threshold resets
   • Predictable billing patterns

Setting up flex billing

Let’s create an example with three tiers:

• Up to 250 orders: $19.99/month
• Up to 500 orders: $39.99/month
• Over 500 orders: $59.99/month

Step 1: Create your first plan

1. Navigate to Plans and select Add plan:

2. Enter your plan details
3. Enable flex billing by checking Enable flex billing for this plan:

4. Configure flex billing settings:

• Capped monthly price: The maximum monthly price you can charge a customer for this plan.
• Additional charge information: Additional information about the plan you want to display to the customer on the charge acceptance screen.

Step 2: Set up usage metrics

Once your usage events are in Mantle and have been consolidated into a usage metric, you can assign this metric to a plan. This will measure the events and determine when flex billing upgrades or downgrades should occur.

To do this, go to the same plan settings, navigate to the Usage billing section, and click Add usage metric. Then, associate the usage metric you want to include in the plan:

Step 3: Configure thresholds

For the Basic plan, which covers up to 250 orders at $19.99/month, we’ll set the threshold from 0 to 250. This ensures that if a customer exceeds 250 orders, flex billing will move them to the next plan.

Set the Pricing Type to Per Unit with Limits. If you want to charge for regular usage in addition to your plan, you can enter a price for your usage and the terms associated:

In our example, we are strictly using plan charges, not combining plan prices with per-usage charges (i.e., the plan price is based on usage rather than a combination of usage price and plan price).

Step 4: Create additional tiers

Now create your Advanced plan at $39.99/month with the same settings as the first plan. The only difference is that instead of the threshold being 0-250 orders, we’ll set it to 251-500 orders:

Apply the same process for the third plan, priced at $59.99/month. Set the threshold to a minimum of 501, and leave the maximum field blank to make it unlimited:

Step 5: Link upgrade paths

Now that we have our plans set up, we can configure which plan customers should upgrade to when they reach their usage thresholds.

Navigate to Plans -> select your plan (in our case Basic) and click Edit:

To enable automatic plan upgrades, check the box labeled Usage charge settings:

Then simply select the flex billing-enabled plan you want the customer to upgrade to once they reach the threshold set for the current plan:

Click Save. Next we can enable the same setting to set the upgrade from the Advanced plan to the Professional plan.

Great! - these plans are now set up with flex billing. If a customer selects a plan:

they’ll see the Shopify charge approval screen but it will have the additional charge information you added to your plan:

Once accepted, the customer will be subscribed to a flex billing plan and automatically upgraded to a new plan once they meet the usage threshold you’ve set.

The customer won’t need to accept the new charge since they’ve already agreed to the capped amount.

Important considerations

• Use the same capped amount across all flex billing plans
• Trials are tracked but won’t trigger upgrades
• Charges occur immediately upon plan changes
• Price differences are prorated automatically

FAQ