Key Takeaways

• A proration credit comes out of unused time on the old plan, not out of cash, and the billing engine issues it the moment the subscription changes.

• Unused days multiplied by the old plan's daily rate gives the credit: a $200 plan downgraded to $80 with 12 days left in a 30-day cycle credits $80.00 against a $32.00 charge, netting $48.00 back.

• Stripe calculates prorations down to the second by default, so a change firing at 14:00 credits fewer hours than the same change at midnight.

• Month length moves the daily rate: 12 unused days on a $200 plan are worth $80.00 in a 30-day month and $77.42 in a 31-day month.

• Proration credits land as negative invoice line items, Stripe never auto-refunds them, and metered usage doesn't prorate at all.

How is a proration credit calculated?

Multiply the unused portion of the cycle by the old plan's daily rate, then net that against the prorated charge for the new plan. Here's a $200 monthly plan downgraded to $80 with 12 days left in a 30-day cycle.

Two details decide whether your number matches the customer's. The first: Stripe prorates down to the second, so a downgrade at 14:00 on day 18 credits 11 days and 10 hours, worth $76.11, not the $80.00 that whole-day math returns, a $3.89 gap that multiplies across a seat-heavy account.

The second is month length. Those same 12 unused days are worth $80.00 in a 30-day month and $77.42 in a 31-day month, because the denominator moves. February moves it further. When a figure looks off by a couple of dollars, I check the billing cycle denominator first.

Where does a proration credit show up on an invoice?

It shows up as a negative invoice line item with its own service period, next to the positive prorated charge for the new plan. Stripe's preview invoice shows that pair: "Unused time on Silver plan" at -$1.66, then "Remaining time on Gold plan" at +$5.41.

Reading one on an invoice:

• Both lines carry a proration flag and a service period starting at the change.

• Stripe marks proration lines discountable: false, so an invoice-level coupon doesn't touch them.

• The credit reduces the draft invoice total without moving cash.

• When the credit exceeds the charge, the balance carries forward rather than paying out.

That separates it from its neighbours. A proration credit isn't a credit memo, which someone issues after the fact against an invoice you've already sent. It isn't a partial refund, which returns money you already collected. The decision in credit note vs refund never comes up, because the engine already made it.

What goes wrong with proration credits?

Most proration bugs come from crediting a price the customer never paid, or from changes stacking faster than the engine reconciles them.

• Crediting an unbilled rate. Stripe's classic billing mode credits at the current price. Upgrade $10 to $20 with proration off, downgrade back to $10 ten days later, and classic credits $6.67 for a rate never invoiced. Flexible mode credits $3.33, the price actually billed.

• Stacked changes compounding. Fourteen gift-code redemptions on one account each fired proration logic, and $1,400 of an expected $2,800 credit balance disappeared with no failed charge. Seven billing edge cases that already broke real systems walks through it.

• Crediting time nobody paid for. A customer who downgrades while an invoice sits unpaid still gets credited for the higher-priced period. Stripe's guidance is to switch proration off while that invoice stays unpaid.

• Expecting usage to prorate. Metered charges aren't subject to proration, so a team counting on a mid-cycle split reconciles by hand.

Related terms

If you're untangling a mid-cycle change, these sit closest:

• Credit memo covers the credit someone issues deliberately against an invoice you've already sent.

• Credit note vs refund walks through the choice between crediting a balance and returning cash.

• Partial refund covers giving back money you've already collected, which proration never does.

• Billing cycle sets the denominator every proration calculation divides by.

• Contraction MRR is what a downgrade does to your revenue after the credit clears.

FAQ

Is a proration credit the same as a refund?

No. A proration credit reduces what the customer owes on a future invoice, while a refund returns money to the card it came from. Stripe doesn't auto-refund a negative proration, so someone has to issue the refund separately.

Does a proration credit expire?

It depends on where the credit lands. A credit written as an invoice line item gets consumed by that invoice. A credit pushed to the customer's balance carries forward until it's used up, so a churning customer can leave a balance behind.

Do upgrades create proration credits too?

Yes. An upgrade credits unused time on the cheaper plan and charges for remaining time on the more expensive one, so both lines still appear. The net comes out positive instead of negative.

Can you turn proration off?

Yes. Stripe's proration behaviour setting, set to none, skips proration items entirely, so the customer pays the full new price at the next renewal with no credit for unused time. Most billing engines expose the same switch.