Skip to main content
When a customer changes plans mid-period, proration decides what they pay for the time left. Kelviq credits the unused part of the old plan and charges for the rest of the period on the new plan. You choose whether that difference is charged now, added to the next invoice, or skipped. Both examples below use monthly plans, with the change made exactly halfway through the month.

​
Upgrade: $100 → $200

The unused half of the old plan is worth a $50 credit. The remaining half of the new plan costs $100. The difference is $50.

​
Downgrade: $200 → $100

The unused half of the old plan is worth a $100 credit. The remaining half of the new plan costs $50. The customer is owed $50. The new plan and its limits apply as soon as the change is made, whichever option you pick. Amounts depend on the exact time of the change.

​
Set your defaults

Open Settings → Subscription proration. There are two defaults:
The Subscription proration settings page with defaults for plan changes and plan version migrations
Switching between monthly and yearly billing always invoices immediately, whatever you choose here. The change starts a new billing period and sets the new renewal date. With No proration, unused time on the old interval isn’t credited.

​
Override per change

Pass prorationBehavior when you update a subscription through the API or SDK. It overrides the default for that change.
To see the exact amounts before you commit, call client.subscriptions.previewUpdate with the same fields, or POST /subscriptions/{subscriptionId}/update/preview/. To keep the old plan until the customer pays for the new one, see Wait for payment before changing access.