Skip ahead to the main page
Partner Huddle
Pages

Stripe proration: check 2 charges after a fee change

Partner Huddle Editorial Team · Published · 10 min read

Why a mid-month change affects two charges

To compare monthly charges after a fee change, separate the old fee, the new renewal amount, and any proration adjustment. The client has been paying one amount, you agree to a new one, and the change lands somewhere between two renewal dates. From the client's side, that can look like two monthly charges that match neither the old fee nor the new fee cleanly. That is where the questions start, usually the week the invoice arrives.

The first charge is the one the client already expects: the renewal under the old fee. The second is the renewal under the new fee, and it may carry an adjustment for the part of the cycle when the change was already in effect. If you can compare those two charges side by side and explain every line, you can answer the questions before the client asks them. If you cannot, the client will do the comparison for you, often with your engagement letter open next to the invoice.

If your firm bills retainers through Stripe, the subscription documentation gives concrete examples you can test against your own setup. Confirm the details against your own billing configuration and your firm's written terms before you change a client's fee.

What Stripe's examples show

Stripe's subscription update reference includes a worked example that is worth reading slowly. It starts with a customer who signs up for a 100 USD price. In the reference's words, "if a customer signs up on May 1 for a 100 USD price, they’ll be billed 100 USD immediately." That first charge is your baseline. Every later comparison starts from it, so write it down before anything else.

Then the example changes the price. The reference says: "If on May 15 they switch to a 200 USD price, then on June 1 they’ll be billed 250 USD (200 USD for a renewal of her subscription, plus a 50 USD prorating adjustment for half of the previous month’s 100 USD difference)."

The same reference also shows a different option. "With this option, the customer is billed 100 USD on May 1 and 200 USD on June 1." In that outcome, the client pays the old price on the first date and the new price on the next date, with no 250 USD figure to explain. Neither outcome is wrong. They are different choices, and the one you pick determines what the client sees.

The reference also explains when proration applies. "When changing prices or quantities, we optionally prorate the price we charge next month to make up for any price changes." The word that matters is optionally. Decide which outcome you want before you make the change, and write that decision into the client note.

Finally, the reference gives you a way to check your decision before the client sees it: "To preview how the proration is calculated, use the create preview endpoint." Treat the preview as a required step. Run it, save the result, and compare it with the two charges you expected. If the numbers differ, stop and find out why before the change goes live.

Choose the effective date on purpose

When you prorate, the effective date determines how much of the current cycle is billed at each fee. In Stripe's example, the switch happens on May 15 and the renewal falls on June 1, so the change sits in the middle of the cycle. Your own change may fall on a different day, and each day moves the numbers.

Two broad choices follow from that. You can make the new fee take effect shortly after the client has received the note, which is the kind of mid-cycle change the Stripe example prorates. Or you can make it take effect on the next renewal, where the client is billed the old price on one date and the new price on the next. What matters is that you pick one on purpose and say which one you picked.

Give the client time to read the note before the effective date. A change announced on the same day it takes effect leaves the client no room to ask questions, and questions are much cheaper to answer before the first charge than after it.

Map both charges before you change anything

Before you touch the subscription, write down five facts on one page: the current fee, the date the current fee started, the new fee, the date the new fee should take effect, and whether you intend to prorate. If you cannot fill in any one of them, you are not ready to make the change.

Next, work out the two charges by hand before you use any tool. For the first charge, the question is what the client should pay at the renewal under the old fee. For the second, the question is what the renewal under the new fee should include. If you intend to prorate, the second charge should contain a visible adjustment that you can explain in one sentence. If you do not intend to prorate, the second charge should equal the new fee with nothing added. Your hand calculation is the check on the preview. When the two disagree, assume the setup is wrong until you prove otherwise.

Then compare your hand calculation with the preview. The preview is the tool, and your notes are the standard. Check three possible causes of a mismatch: the effective date is off by a day, the old fee is not the one you think it is, or the change was made to a different line than the one you meant. The preview shows you which number is different. Your notes tell you whether that number is supposed to be different.

Walk through one change from start to finish

Here is how the Stripe example looks when you apply it to a retainer. Assume a client pays a 100 USD monthly fee, billed on May 1, and you decide to raise it to 200 USD effective May 15.

Step one: write down the baseline. The May 1 charge is 100 USD, and you expect that charge to stand.

Step two: decide on proration. If you prorate, the June 1 charge should be 250 USD in the pattern Stripe describes: the 200 USD renewal plus a 50 USD adjustment for half of the 100 USD difference. If you do not prorate, the June 1 charge should be 200 USD, which matches the option the same reference describes.

Step three: run the preview. Confirm that the preview shows the decision you made in step two. If it shows a different June 1 amount, do not send the note yet.

Step four: send the client note. For a prorated change, explain that the next charge includes the new fee plus an adjustment for the part of the cycle after the change, and say what that adjustment is. For a non-prorated change, explain that the next renewal will be at the new fee with no proration adjustment.

Step five: after the first charge that reflects the change appears, check it against your notes and save them together.

Your account may behave differently from the example, which is why the preview matters more than the example. Use the numbers above as a pattern for checking, not as a promise about what your subscription will show.

Check every line item

A Stripe subscription can hold several prices at once. The update reference describes the items parameter this way: "A list of up to 20 subscription items, each with an attached price." A monthly retainer might be split into bookkeeping, payroll support, and a tax preparation add-on, each with its own price. If you change the fee for one of those items, you change one line. Make sure that line is the one you meant to change, and check the others to confirm they were not touched.

This matters most when the client is confused about the total. A client who sees two charges and asks why the second is larger may be looking at the sum of several items, not one fee. Before you explain the difference, list every item on the subscription with its price, then show the client which item changed. A short table in the client note works well for this.

Write the client note

The client should hear about the change before the first charge that reflects it. Keep the note short and plain. It should name the current fee, the new fee, the effective date, and the date of the next charge. If the next charge includes a proration adjustment, say so in one sentence and say what the adjustment is for. If it does not, say that the next renewal has no proration adjustment.

Draft the note, then enter the amounts and dates from your preview. A note might read: the monthly fee changes from your current amount to the new amount, effective on the change date. Your next charge, on the renewal date, will be the new amount plus a prorating adjustment for the days between the change date and the renewal date. Reply to this note if anything on the invoice differs from what is described here.

Avoid apologizing for the change or framing it as a mistake. Describe it as what it is. Give the client a contact for questions and answer them quickly. A fee change that arrives with a clear note and a fast answer to the first question usually causes less friction than one that arrives with no explanation at all.

Settle the decisions with your team

Small firms often make fee changes informally, and that is where mistakes start. Before the first change goes out, agree on a few decisions in writing.

Decide who may approve a mid-cycle fee change. One person should own the decision, even if several people review the numbers. Decide who runs the preview and who checks it. Two sets of eyes on the same two charges catch errors that one person reading quickly will miss. Decide who sends the client note and who answers the first questions, because a client who gets two different answers from two people will assume the firm is confused.

Decide the default. Will your firm prorate by default, or only when a client asks? Will changes take effect immediately or at renewal? A default lets staff act consistently without re-deciding each case. Write it in your internal billing notes, and update it when the firm's policy changes.

Keep the policy with the firm, not with the software. Your engagement terms should say how fee changes are handled, and your staff should follow the same process each time. Stripe provides the mechanism, but the policy is your firm's call.

When the numbers do not match

A preview that does not match your notes is useful information. It means something in your setup differs from what you expected. Stop before you send the client note, and work through the likely causes in order.

Start with the effective date. A change entered for the wrong day moves the proration, and the result looks like a bug when it is really a date error. Next, check the item. If the subscription has more than one line, confirm that the change was made to the line you meant. Then check the old fee. If the baseline is not the amount you think the client has been paying, every later number will be off.

If those three checks pass, look at whether the change was already made, perhaps by a colleague or an earlier attempt. Duplicate changes are easy to make when two people are working from the same client record. Check the subscription's history before you change it again.

If you still cannot explain the difference, get help from the people who run your billing setup rather than guessing. Do not send the client a number you cannot explain. Tell the client when you expect to confirm the amount, and keep to that date.

Common mistakes

The most common mistake is changing the fee without deciding on proration first. The update goes through, the client sees an unexpected amount, and the firm spends a week reconstructing what it meant to do. A second common mistake is comparing the new price to the old invoice and assuming there is an error.

Other mistakes are quieter. Firms forget that a multi-item subscription can have several prices, and they change one and assume the rest moved too. They skip the preview because the change seems small. They tell the client after the first charge instead of before. And they treat the fee change as a private billing matter when it is really a change in the client's terms, which deserves the same care as any other change to the engagement.

A short checklist

  • Write down the current fee, the new fee, the effective date, and whether you will prorate.
  • Calculate the first charge and the second charge by hand.
  • Run the preview and compare it with your numbers.
  • List every subscription item and confirm that only the intended one changed.
  • Send the client a plain note before the first charge that reflects the change.
  • Save the note, the preview, and the figures with the engagement letter.

Sources