Proration is the practice of calculating a partial charge or credit for a subscription based on the portion of a billing period actually used. It typically comes up when a subscriber changes plans, changes quantity, or changes their bill date in the middle of a billing cycle.
A subscription billing period usually has a fixed price attached to it, and proration exists for the moments when that fixed period gets interrupted, such as a mid-cycle upgrade, downgrade, quantity change, or bill date change. Whether a change triggers full proration, no proration, or something in between is a configuration choice rather than a fixed rule.
Why proration matters
Without proration, every mid-cycle subscription change would either overcharge the subscriber for time they did not use, undercharge the business for time it delivered service, or force every change to wait until the next renewal. None of those outcomes work well as a business grows.
Proration lets a subscription business match billing to actual usage down to the day, which keeps invoices defensible when a subscriber asks why they were charged a given amount. It also gives merchants a lever: proration behavior can be tuned differently for upgrades, downgrades, and quantity changes, so the billing logic matches the business's real policies instead of a single hardcoded rule.
How proration works
Proration generally works in two directions at once:
A credit for the unused portion of what the subscriber is leaving behind, such as the remaining days on a plan they are moving off of.
A charge for the used or upcoming portion of what they are moving to, calculated only for the days that apply.
A merchant can decide, for example, that an upgrade charges the new plan's prorated amount immediately but issues no credit for the old plan, or that a downgrade waits until the next renewal instead of adjusting mid-cycle.
A mid-cycle bill date change shows the mechanics. Say a subscription currently bills on the 10th of each month, and the merchant changes it to bill on the 16th instead, with the change happening on the 7th of the month.
The subscriber gets a prorated credit for the days between the change date and the old bill date: 3 days (the 8th, 9th, and 10th).
The subscriber is charged for the days between the old bill date and the new one: 8 days (the 8th through the 15th).
The new billing period begins on the 16th, and future cycles follow that new date.
If the new bill date were earlier in the cycle instead of later, for example moving from the 10th to the 2nd starting on the same day, the same logic applies but stretches the charged period across more days: a 3-day credit, then a charge for the days from the 8th through the following month's 2nd, with the new cycle then starting on the 2nd.
The same credit-then-charge logic applies to plan upgrades, downgrades, and quantity changes. What differs is which side gets prorated and which does not, and that is a setting rather than a fixed behavior.
Proration settings and options
Proration is not one-size-fits-all, and Recurly's subscription change API exposes that directly through a proration_settings object with two independent controls:
Charge: full_amount, prorated_amount, or none. This determines how the new charge resulting from a change is calculated.
Credit: full_amount, prorated_amount, or none. This determines how any credit resulting from a change is calculated.
Because these are set independently, a merchant can configure a full charge for the new plan with no credit for the old one, a fully prorated charge and credit on both sides, or no financial adjustment at all if the change should simply take effect at the next renewal. Prorated line items also carry their own proration rate, so the exact fraction applied to a given charge or credit shows on the invoice rather than hiding in a lump sum.
Benefits of proration
Subscribers are charged for what they actually used, not a full period they only partially consumed.
A prorated line item with a visible rate gives support and billing teams a clear answer when a subscriber asks about a mid-cycle charge.
Configurable charge and credit behavior means upgrades, downgrades, and bill date changes do not all have to be handled the same way.
Proration makes it practical to apply a plan or quantity change immediately instead of forcing subscribers to wait until their next renewal.
How Recurly handles proration
Recurly's subscription change endpoints (create, preview, and purchase) expose proration_settings with independent charge and credit controls, so merchants can define proration behavior per change type rather than accepting one default across the board. Recurly also supports proration on bill date changes directly in the admin UI and the API: changing a subscription's next bill date can immediately generate the matching credit and charge based on the newly selected date. This is standard, generally available functionality.
Proration behavior can also vary by product surface within Recurly's platform, so it is worth confirming with your account team exactly how proration applies to your specific plan change scenario.
Frequently asked questions
What triggers proration? Most commonly a mid-cycle plan upgrade or downgrade, a quantity change (such as adding or removing seats or add-ons), or a change to a subscription's bill date. Any change that happens partway through an existing billing period is a candidate for proration.
Is proration always automatic? No. Proration behavior is typically a setting a merchant configures for a given type of change, not a fixed system behavior. A merchant can choose full proration on both the charge and credit side, proration on only one side, or no proration at all for a given change.
How is a prorated amount calculated? Proration is calculated as a fraction of the billing period, based on how many days remain (or have passed) relative to the total length of that period, applied to the plan's price for that period. The exact math depends on the specific charge and credit settings in effect for that change.
Does proration apply to add-ons and quantity changes, or only plan changes? It can apply to any mid-cycle change with a price impact, which includes quantity changes and add-on changes as well as plan changes, not only a full plan swap.
Can I turn proration off? Yes. Proration settings support a none option for both charge and credit, so a merchant can choose to apply no proration and instead let a change take full effect only at the next renewal.
