Standard price with metered overage applied to next invoice

296 views
Skip to first unread message

Ross

unread,
Feb 21, 2022, 5:05:48 PM2/21/22
to Stripe API Discussion
I would like to create a subscription with a flat fee, billed immediately, which entitles users to X number of API usages during the billing period, with a metered rate for overages billed on the next invoice. 

For example:
Client subscribes to standard plan, which grants 100 requests per month, and $.01 per request over 100 which is $100/month. 
They are immedietly invoiced $100. 
During the month, they make 101 requests, therefor on the following invoice, they are billed $100 + $.01 = $100.01 which reflects the 1 request of overage. 

Is this possible with a single Price? Or must I include a standard monthly Product/Price + metered Product/graduated price on the subscription?

Thanks!

Remi J.

unread,
Feb 21, 2022, 5:07:56 PM2/21/22
to api-d...@lists.stripe.com
Hello Ross,

In your case, since you want to charge the base $100 price upfront, the best option is to have 2 separate Prices. One for the base Price and a separate one for the overage usage, though I'd recommend reporting all usage and making the first 100 free that way you don't have to keep track of when they go over 100 to start recording the first usage record.

Hope this helps!
Remi

--
To unsubscribe from this group and stop receiving emails from it, send an email to api-discuss...@lists.stripe.com.

Ross

unread,
Feb 21, 2022, 5:36:20 PM2/21/22
to api-d...@lists.stripe.com
Thanks Remi 

Using your proposed option of a single price with the first 100 requests free, hi ow would the base fee get charged?

In my scenario, the client should be charged the base fee regardless if they use the service or not in a given month. 

Also; it seems 2 subscriptions may be required, as a client may want to pay the base fee for the year, while they’re charged for any overages monthly. 

Thoughts? 

To unsubscribe from this topic, visit https://groups.google.com/a/lists.stripe.com/d/topic/api-discuss/9HRX282xwY0/unsubscribe.
To unsubscribe from this group and all its topics, send an email to api-discuss...@lists.stripe.com.

Remi J.

unread,
Feb 21, 2022, 5:41:30 PM2/21/22
to api-d...@lists.stripe.com
Hello,

A Subscription can have more than one Price as long as they are on the same billing cycle (both monthly or yearly for example). Earlier you didn't mention that one fee would be done yearly and the other monthly, so it would have been as simple as adding both Prices to the same subscription. Each month, it'd have billed $100 as the base fee (price_A) and the extra overage usage based on reported usage records (price_B). This doesn't require 2 subscriptions and is documented here: https://stripe.com/docs/billing/subscriptions/multiple-products

Now, if you want the base fee to be billed yearly and the usage to be billed monthly, this approach will not work unfortunately. In that case, you will need 2 separate subscriptions, one on each Price, and they will be charged separately each month/year depending on the Price billing cycle.

I hope this helps! I'd recommend contacting our support team directly for any follow up questions and they can help you set all of this up right for your business. You can contact them here: https://support.stripe.com/contact

Best,
Remi


Ross

unread,
Feb 21, 2022, 6:12:20 PM2/21/22
to Stripe API Discussion, re...@stripe.com
Thanks 

But just to clarify, I want the base price to be billed at the start of the billing cycle, and overage during that period to be applied the next invoice. That is the part that I see no option for. 

Remi J.

unread,
Feb 21, 2022, 6:16:47 PM2/21/22
to Stripe API Discussion
Hello,

That's definitely possible and the approach is to create a Subscription with 2 separate Prices. One is price_A and bills $100 monthly, no metered billing or usage record. Another one is price_B and bills $0.01 per record with a free tier of 100 requests. When you create the Subscription, we charge $100 upfront. Over the course of the month you report usage for 789 records. Next month, we charge $100 for the base Price for next month and $6.89 for metered usage in the current month (since the first 100 are free) and it bills $106.89 total in one invoice, and that repeats every month.

I do think you want to chat with our support team directly for follow up questions as they can look into your account, your Price configuration and any other questions you have: https://support.stripe.com/contact

Best,
Remi
Reply all
Reply to author
Forward
0 new messages