Clavem

Proration

Proration is the adjustment made when a subscription changes in the middle of a billing period, so the customer is credited for the unused time on the old plan and charged for the remaining time on the new one.

How it works

A billing period is a span of time, and the customer pays for it in advance. If the plan changes halfway, two things are true at once: some of the old plan went unused, and some of the new plan is about to be used. Proration puts a price on both and nets them.

Stripe’s documentation gives the example of a customer who upgrades from a 10 USD monthly plan to a 20 USD plan halfway through the period. The unused half of the old plan is a credit of 5 USD, the remaining half of the new plan is a debit of 10 USD, and the customer is billed an additional 5 USD.

Details that matter, as of November 2026:

  • By default Stripe calculates prorations down to the second. You can change the granularity, for example to days, with proration customizations.
  • Positive prorations are not billed immediately by default, and negative ones are not refunded automatically.
  • When a discount is on the subscription, Stripe uses the discounted price to calculate the credit or debit.
  • You can preview a proration before applying the change.

Example: upgrade on day 10

An illustrative subscription moves from a 29.00 monthly plan to a 79.00 plan on day 10 of a 30-day month. The simple day math, with 20 days left:

Line Calculation Amount
Credit, unused old plan 29.00 x 20 / 30 -19.33
Debit, rest of new plan 79.00 x 20 / 30 +52.67
Net +33.33

Stripe works by the second rather than by whole days, so the real figure differs by cents. The downgrade is the mirror image: a net credit of 33.33 that Stripe does not refund automatically. Tax, if you collect it, applies on top.

Proration versus a refund

A refund gives money back for something the customer already paid for and wants to undo. Proration is arithmetic inside an ongoing subscription: the customer keeps paying, but at a rate that matches what they used. A full refund of a one-time order is a separate event; see refund policy.

How Clavem handles it

Clavem does not prorate anything. Stripe does, and the license follows the subscription. A subscription license expires at the end of its paid period plus three days, and each invoice.paid moves the expiry to the end of the period the invoice paid for. The expiry date comes from what Stripe reports, not from a calculation in Clavem.

The Clavem docs describe renewals, cancellations and refunds. They do not describe how an invoice made only of proration items is read, or a plan change moving a license from one Clavem product to another. Test an upgrade in Stripe test mode before you offer plan switching to customers, and check the license’s limit and expiry afterwards in the dashboard. Setup is in Connecting Stripe, and the surrounding design in subscription licenses with Stripe Billing. Subscribers can change plans themselves in the customer portal if you enable it.

Questions

Does Stripe prorate automatically?

Changes such as adding or removing a subscription item create prorations by default. Stripe calculates them down to the second unless you change the granularity, and you can set the proration behavior when you update a subscription.

Is a downgrade refunded?

Not automatically. Stripe's documentation says negative prorations are not automatically refunded and positive ones are not immediately billed, although you can do both manually.

Sources

  1. Stripe Docs, Prorations (checked November 2026)