fabry_billing-threshold | Stripe Developers | Page 1

proven gladeBOT Mar 23, 2026, 4:05 PM

#

👋 Welcome to your new thread!

⏲️ We'll be here soon! Typically we respond in a few minutes, but sometimes we might take a bit longer if the server is busy or if you have a particularly tricky question.

⏱️ We close idle threads, which makes them read-only. Once a thread is closed it won't be reopened, but you can always start a new thread if you have another question.

🔗 This thread will always be available, even after it's closed. You can find it again using Discord's search, or you can save this link: https://discord.com/channels/841573134531821608/1485670872374186084

📝 Have more to share? Add more details, code, screenshots, videos, etc. below.

#

rich briar Mar 23, 2026, 4:06 PM

#

Adding more context:
Working on a SaaS with both a fixed-price usage plan product and a credits product which keep track of overuse, when overuse gets spent completely (so the current invoice bill is higher than 30€), a new cycle should start

surreal thunder Mar 23, 2026, 4:08 PM

#

fabry_billing-threshold

rich briar Mar 23, 2026, 4:09 PM

#

Also, I can confirm the billing threshold is correctly configured on the Stripe Dashboard

surreal thunder Mar 23, 2026, 4:09 PM

#

👋 I don't really get what this means

or more is met, a new invoice does NOT get created and the current one paid correctly.

rich briar Mar 23, 2026, 4:11 PM

#

Sorry, let me rephrase this:
On the current billing cycle, If I exceed 30€ (tax excl.) of usage, the invoice should be paid and the next cycle should start, but this isn't happening

surreal thunder Mar 23, 2026, 4:15 PM

#

Okay, can you share how you are reproducing this? Exact code, exact example object id (Subscription id, how you reported usage, what you see on the Upcoming Invoice, etc.)

Note that usage is not aggregated in real time so it takes some time for the new Invoice to be created

rich briar Mar 23, 2026, 4:32 PM

#

Sure, this is an excerpt of what I'm doing:

Stripe webhook catches "customer.subscription.created" ->
Some internal business logic -> Update stripe subscription and attach billing_thresholds: {
amount_gte: 3000,
},

In the stripe dashboard, this works fine, the event gets fired correctly:

200 /v1/subscriptions/sub_1TE9kkLZKpRE4i30oTUhjb4X

With the following POST request body:
{
"billing_thresholds": {
"amount_gte": "3000"
}
}

In the stripe dashboard, the following text gets displayed:
Soglia di fatturazione
"Il raggiungimento di un totale non addebitato pari a 30,00 € al lordo delle imposte attiverà una nuova fattura. Il periodo di fatturazione rimarrà invariato." -> "Billing Threshold
When your total outstanding balance reaches €30.00 (before taxes), a new invoice will be generated. The billing cycle will remain unchanged."

#

This is the current invoice which should trigger the next cycle:

#

surreal thunder Mar 23, 2026, 4:40 PM

#

sorry a lot of it is in another language so hard to grasp those UIs

Are you doing all of this in Test mode? If so can you create a Subscription with billing thresholds and then report usage well over 30€ and see what happens?

rich briar Mar 23, 2026, 4:58 PM

#

This is in sandbox mode, should I test in test mode?

rich briar Mar 23, 2026, 4:58 PM

#

surreal thunder sorry a lot of it is in another language so hard to grasp those UIs Are you doi...

Hahah I get it sorry, I'll see if I can switch UI the lang real quick

surreal thunder Mar 23, 2026, 5:01 PM

#

really I don't need screenshots

#

I need a clear understanding of your exact code and how you reproduce each thing

rich briar Mar 23, 2026, 5:02 PM

#

I can pass you the entire sub object

#

📎 sub.json

#

To repro, I'm using sandbox mode, with a daily subscription

surreal thunder Mar 23, 2026, 5:06 PM

#

are you writing code though or doing all of this in the UI? Sorry to push, but really what I'm asking for is end to end code that does all the steps sequentially in the right order

Create Sub with billing_thresholds (no need to update async)
Report usage multiple times
Wait for Invoice to be created

rich briar Mar 23, 2026, 5:09 PM

#

Yes, I'm writing code and monitoring through the UI.

For sub creation, I don't create it, I just get a customer.subscription.created event after a checkout session is completed, then call the stripe subscription api to attach billing threshold

To report usage, I have a simple UI button that fires the metered event which gets correctly tracked in the invoice

The invoice still isn't getting created after some hours, and I've exceeded the 30€ threshold

surreal thunder Mar 23, 2026, 5:10 PM

#

For sub creation, I don't create it, I just get a customer.subscription.created event after a checkout session is completed, then call the stripe subscription api to attach billing threshold
sure but you can bypass that to run an end to end test just to test billing thresholds

#

I'm looking in parallel though

rich briar Mar 23, 2026, 5:12 PM

#

surreal thunder > For sub creation, I don't create it, I just get a customer.subscription.create...

With the stripe CLI?

surreal thunder Mar 23, 2026, 5:12 PM

#

No with just code the same way you update the Subscription in your webhook handler right now

rich briar Mar 23, 2026, 5:14 PM

#

This is the code which updates the sub (inside the subscription created handler)

surreal thunder Mar 23, 2026, 5:16 PM

#

yeah sorry

proven gladeBOT Mar 23, 2026, 5:16 PM

#

surreal thunder Mar 23, 2026, 5:16 PM

#

I don't need a picture to be clear

#

I was hoping you could spend a few minutes writing a really simple end to end test that does all the steps, no Checkout, no webhook, no Dashboard usage. Just spending a couple minutes trying what I was explaining.

#

My gut: this just never works with MeterEvents, it's a feature for our older "usage based billing" integration via UsageRecords. But at this point let's pause and let me investigate and confirm, that'll be easier for you than all the back and forth

lucid spindle Mar 23, 2026, 5:21 PM

#

fyi i'm taking over for my colleague!

surreal thunder Mar 23, 2026, 5:22 PM

#

(sorry clarified, we are the ones testing and then we'll confirm)

lucid spindle Mar 23, 2026, 5:40 PM

#

ok, i finished a test of this and i think you're right in that the billing threshold isn't being respected at all

#

gonna run a couple more tests to make sure it isn't a me problem

lucid spindle Mar 23, 2026, 6:05 PM

#

ok yes, i've tested this a few ways now and i am pretty sure meters aren't supported for billing_thresholds currently. the best solution i can think of at the moment is to use billing alerts, which allows you to configure a webhook alert that will fire when a user hits a given threshold. once that event fires, you can update the subscription's billing cycle anchor to "now" to reset the billing cycle anchor and send an invoice. from there, you would need to create a new alert as each alert is a one-off and must be recreated after it fires.

proven gladeBOT Mar 23, 2026, 6:46 PM

#

lucid spindle Mar 23, 2026, 7:34 PM

#

ok sorry, i just tested again and this should actually work. in a few of my tests it looked like it wasn't working, but meters are a little tricky to work with alongside test clocks because they can take a while for us to aggregate them on our side

#

so what you need to do is

create a customer + test clock
create a subscription with a billing thresold
log enough meter events to trigger the threshold
wait for several minutes in real time for our system to aggregate the meter events (in my testing 5 minutes was usually long enough, but the aggregation time is variable)
advance your test clock by a day or so (this should generate an invoice for the billing events aggregated so far)
inspect your subscription + invoice to verify that the invoice has been generated
advance your test clock one more full billing period (this should generate a $0.00 invoice)

#fabry_billing-threshold