Stripe Monthly to Annual Switch: What QuickBooks Receives
A monthly-to-annual switch in Stripe resets the billing date, credits unused time and charges a year at once. What reaches QuickBooks and how to defer it.
A customer on your $60 monthly plan pays on April 1. On April 11 they click "switch to annual" and pick the $600 yearly price. Within seconds, Stripe has moved their billing date to April 11, credited them for the 20 days of April they had already paid for, charged them for a full year, and sent you one invoice that mixes all three.
Nothing about that is wrong. But every one of those three moves lands in your books, and two of them surprise people at month-end: the billing date they spent months aligning to the 1st is gone, and the full $600 sits in April's income unless someone defers it.
Interval switches, synced as Stripe bills them. With Acodei's Invoice Sync, a paid-plan feature, a QuickBooks invoice is created when a Stripe invoice is finalized, with its lines reproduced as your mapping settings allow, and the payment is applied when it is paid. Start a free trial.
This post walks through what Stripe does on a monthly-to-annual switch, a worked example with real numbers, what QuickBooks receives under each Acodei setup, how to treat the annual charge as deferred revenue, and the checks worth running before you offer the upgrade button.
What Stripe does when the interval changes
Changing a subscription's price usually leaves the billing date alone. Changing its interval does not. Stripe's change-price guide spells out the difference: "switching a customer from one monthly subscription to another doesn't change the billing dates. However, switching a customer from a monthly subscription to a yearly subscription moves the billing date to the date of the switch."
The billing cycle guide names the mechanism. The billing_cycle_anchor "resets to the current time when switching to a price with a different recurring.interval." You don't pass any anchor parameter for this to happen. Changing the price is enough.
A reset anchor means an immediate bill. The change-price guide says: "Stripe immediately attempts payment when a subscription's billing cycle anchor is reset." So the switch doesn't wait for the next renewal on May 1. The annual period starts on April 11, and so does the invoice for it.
Three things happen in one operation:
- The billing date moves to the moment of the switch. Future renewals land on April 11 every year.
- A credit is created for the unused remainder of the monthly period, which the customer already paid for, as long as prorations are on. That is the default, because
proration_behaviordefaults tocreate_prorations. - An invoice is generated and payment is attempted for the annual price minus that credit.
If your subscriptions use flexible billing mode, the billing cycle guide adds a nuance. In flexible mode, resetting the anchor to now "doesn't automatically generate a new invoice" on its own. But it lists an exception that covers this exact case: "If you also change subscription items alongside the BCA reset so that the prorations don't fully cancel, Stripe generates an invoice immediately regardless of proration_behavior." A monthly-to-annual switch changes the item and leaves a large net charge, so the invoice still arrives on the day.
Worked example: $60 monthly to $600 annual on April 11
Take the customer from the opening. April has 30 days, and the monthly period runs from April 1 to May 1.
- April 1: the monthly renewal invoice, $60.00, is paid.
- April 11: the customer switches to the $600 yearly price. 10 days of April are used and 20 remain.
The April 11 invoice carries two lines:
| Line | Amount |
|---|---|
| Annual plan, April 11, 2026 to April 11, 2027 | $600.00 |
| Unused time on the monthly plan (20 of 30 days) | -$40.00 |
| Amount due | $560.00 |
The credit is 60 × 20/30 = $40.00. Stripe prorates to the exact time of the change, so on a real invoice the cents shift with the hour you made the switch. Use Stripe's preview of the upcoming invoice to see the exact figure before you commit.
Now add up the cash. The customer paid $60 on April 1 and $560 on April 11, $620 in total. That $620 is exactly 10 days of monthly service ($20) plus one year of annual service ($600). Keep that reconciliation in mind, because it is how you check the QuickBooks side later.
The credit line is worth reading closely. In Stripe's own example on the prorations guide, the credit is a line described as "Unused time on Silver plan after 01 Sep 2020", and it carries the old plan's price, not the new one. In this case that means the -$40 line references your monthly Price, while the $600 line references your annual Price. That matters for product mapping, covered below.
The default is a credit, not a refund
Stripe's prorations guide is direct about this: "Negative prorations aren't automatically refunded and positive prorations aren't immediately billed, although you can do both manually."
On an upgrade to annual, the credit is small next to the charge, so it is simply netted against the annual price on the same invoice. Nobody has to issue anything. That is the clean case.
Two variations are not clean.
Proration turned off. Pass proration_behavior=none and the customer pays the full $600 with no credit for the 20 days of April they already paid for. The billing cycle guide warns that "Disabling proration might result in overcharging your customer." In the books, April's $60 monthly invoice stays fully in income although service on that plan ended on April 11.
An unpaid monthly invoice. If the April 1 invoice hasn't been paid when the customer switches, Stripe still credits the unused time. The prorations guide explains that Stripe calculates prorations "assuming that any previous invoices for the subscription will eventually be paid", so a customer "might receive a credit for unused time on the higher-priced plan, even if they haven't paid for that time yet." Stripe's guidance is to disable prorations when the latest invoice is unpaid, and then void that old invoice, because otherwise the approach "can lead to double payment if the customer eventually pays the old invoice."
The reverse switch, annual to monthly, flips the proportions. The credit for unused annual time is large and the monthly charge is small, so the invoice nets negative and Stripe holds the difference as customer balance rather than refunding it. That is a different bookkeeping problem, covered in the customer balance post.
When the annual payment fails
The switch is not conditional on payment. The change-price guide: "When billing is performed immediately, but the required payment fails, the subscription change request succeeds and the subscription transitions to past_due."
So a declined card leaves you with a customer on the annual price, a billing date moved to April 11, and an open $560 invoice. If you sell upgrades through a self-serve button, this is the case to plan for. Stripe's pending updates feature can hold a subscription change until payment succeeds. Check its list of supported parameters against your own switch flow before you rely on it.
For the books, an unpaid switch invoice is a receivable like any other. With Acodei's Invoice Sync on, the QuickBooks invoice is created when the Stripe invoice is finalized, so it sits open in Accounts Receivable until Stripe reports it paid. The payment is then created and applied to it.
What QuickBooks receives
What lands in QuickBooks depends on how your Acodei account is set up.
With Invoice Sync on. Invoice Sync is available on paid plans and is switched on per company under Account Mapping, in the Premium Features block. When the April 11 Stripe invoice is finalized, Acodei creates a QuickBooks invoice that reproduces its line items, and tax lines, as your mapping settings allow. Each line uses the product returned by Multiple Product Mapping if it is enabled, and the default product otherwise. When Stripe reports the invoice paid, Acodei creates a payment receipt and applies it to that QuickBooks invoice.
With Invoice Sync off, on a real-time account. Acodei books a successful Stripe charge as a QuickBooks sales receipt by default, with line items resolved through product mapping and unmapped lines going to the default product. The $560 charge arrives that way, like any other charge.
On the daily balance summary. Accounts on the daily summary get one aggregated receipt per day instead of a record per charge, so the switch is one more amount inside April 11's summary.
Whichever setup you use, run the $620 check from the worked example. April 1's $60 and April 11's $560 should both be in QuickBooks, and together they should equal 10 days of monthly service plus one year of annual service.
Mapping: monthly and annual prices are different Prices
Most businesses that sell both intervals create one Stripe Product with two Prices: price_monthly and price_annual. How that reaches QuickBooks depends on the mapping rule you choose.
Product ID mapping with the pricing tier stores both the Stripe Product ID and the Price ID. Acodei's documentation uses this exact case as its example: it differentiates between a monthly and an annual price on the same product, so each can go to its own QuickBooks product. If you report monthly and annual revenue separately, or post annual plans to a different income account, this is the rule to use.
Product ID mapping without the pricing tier sends every charge and invoice for that product to the same QuickBooks product, whichever price was used. It is simpler, and fine if you don't need the split.
Transaction Value mapping compares the gross amount to a fixed value you enter. It is the weakest choice here, because a switch invoice is $560 in this example and some other amount for every other customer, depending on the day they switched. No fixed value matches all of them.
Two follow-ups matter for the credit line:
- Keep the monthly rule while switches are happening. The -$40 line references the monthly Price, so it is matched by whatever rule covers the monthly Price. Acodei applies rule changes to future transactions only, and a retry from Sync Errors uses the current rules. If you delete or repoint the monthly rule while customers are still switching, their credit lines follow the new setup, not the one their April 1 charges used.
- Be careful archiving the monthly Price. Acodei's documentation notes that when a price is archived in Stripe, its mapping remains, and the next attempt to sync a transaction from that archived price might fail if it is no longer valid in Stripe. If you plan to retire monthly billing, confirm on one synced switch invoice that the credit line still lands where you expect before you archive anything.
If the credit line lands on a different QuickBooks product from the April 1 monthly charge, the two won't net out. Your monthly product shows $60 of April income and the -$40 sits somewhere else, overstating one account and understating another by the same $40.
The annual charge is deferred revenue
Here is the part no sync decides for you. On an accrual basis, the $600 annual line is not April's income. It is 12 months of service paid in advance, which makes it deferred revenue: a liability that becomes income as each month of service is delivered.
The credit line, by contrast, needs no adjustment if it lands on the monthly product. The April 1 invoice put $60 of monthly income in April, the -$40 takes 20 days of it back out, and the $20 left is exactly the 10 days of service delivered. The proration did the accrual work for you.
So only the annual line needs a schedule. Recognizing it by day, $600 over 365 days is about $1.64 a day:
| Period | Recognized | Still deferred at period end |
|---|---|---|
| April 11 to 30, 2026 (20 days) | $32.88 | $567.12 |
| May 2026 (31 days) | $50.96 | $516.16 |
| June 2026 (30 days) | $49.32 | $466.84 |
| And so on, by days in each month | $46.03 in a 28-day February | $0.00 after April 10, 2027 |
There are two common ways to get there in QuickBooks:
- A month-end journal entry. Let the invoice post to an annual subscription income account, then at April 30 debit that income account $567.12 and credit a Deferred Revenue liability account. Each following month, move that month's share back from Deferred Revenue to income.
- QuickBooks revenue recognition. QuickBooks Online Advanced has a revenue recognition feature that spreads an item's revenue over a schedule from the line's service date. It is optional, and attaching a schedule to an item changes what QuickBooks requires on every line that uses it. The revenue recognition service date post covers what that means for synced invoices before you turn it on.
Either way, the bookkeeping decision is the same: annual prices go to a product whose revenue you plan to spread, and monthly prices go to one you don't. That is the practical reason to map the two Prices separately.
The billing-date reset you didn't plan
If you aligned every customer to bill on the 1st, an interval switch quietly undoes it. The customer from the example now renews on April 11, and that will be true every year until something resets it again. The billing cycle anchor post covers how to set and restore an anchor on purpose, and the stub invoice that comes with it.
For reporting, it helps to tell switch invoices apart from renewals. In Stripe's invoice object reference, the billing_reason value subscription_update is described as "A subscription was updated." Check the value on your first switch invoice, and filter on it if you report renewals and mid-cycle changes separately. The billing_reason post lists every value.
If a customer needs an annual platform fee and a monthly usage price at the same time, rather than switching from one to the other, that is a mixed-interval subscription, and the anchor rules differ.
A checklist before you ship the "switch to annual" button
- Decide on prorations. Keep the default
create_prorationsunless you have a reason not to. Turning it off overcharges customers who paid for the current month. - Handle the unpaid-invoice case. If the latest monthly invoice is unpaid, disable prorations for that switch and void the old invoice, as Stripe recommends.
- Preview the invoice. Show the customer the exact amount due, credit included, before they confirm.
- Plan for a decline. A failed payment leaves the switch in place and the subscription
past_due. Decide whether you dun, revert, or hold the change. - Map monthly and annual Prices separately. Use Product ID mapping with the pricing tier, so the annual line can go to a product whose revenue you defer.
- Keep the monthly rule in place. Credit lines on switch invoices reference the monthly Price.
- Set up the deferral. Either a month-end journal entry or a revenue recognition schedule, decided before the first annual invoice lands.
- Check one switch end to end. Confirm that the Stripe invoice, the QuickBooks record, the product on each line, and the $620-style cash check all agree.
Frequently asked questions
Does switching a Stripe subscription from monthly to annual change the billing date?
Yes. Stripe states that switching from a monthly to a yearly subscription moves the billing date to the date of the switch, because the billing cycle anchor resets to the current time whenever the new price has a different recurring interval. The customer renews on that date every year afterwards.
Does Stripe charge the annual price immediately when a customer switches?
Yes. Stripe immediately attempts payment when the billing cycle anchor resets, so the annual invoice is created and charged on the day of the switch, minus any credit for unused monthly time. If the payment fails, the switch still goes through and the subscription becomes past_due.
Does the customer get credit for the unused part of the month?
With the default proration behavior, yes. Stripe adds a negative line for the unused time on the monthly plan to the switch invoice, and nets it against the annual price. With proration turned off, there is no credit, and Stripe notes that disabling proration might overcharge the customer.
How does a monthly-to-annual switch appear in QuickBooks?
With Acodei's Invoice Sync on, the finalized Stripe switch invoice becomes a QuickBooks invoice with its lines reproduced as your mapping settings allow, and the payment is applied to it when paid. With Invoice Sync off on a real-time account, the charge is booked as a sales receipt by default. Daily-summary accounts include it in that day's aggregated receipt.
Should the annual payment be recorded as income in QuickBooks?
On an accrual basis, not all at once. An annual payment covers 12 months of service, so it is deferred revenue that becomes income month by month. Record it with a month-end journal entry to a Deferred Revenue liability account, or with QuickBooks Online Advanced revenue recognition, and map annual prices to their own QuickBooks product so the deferral applies only to them.
The point
A monthly-to-annual switch is three events in one: a billing date reset, a credit for unused time, and an immediate annual charge. Stripe handles all three correctly by default. Your books need two decisions from you: map the annual Price to its own QuickBooks product, and defer the annual line instead of letting a year of revenue land in one month.
Switch invoices, in QuickBooks. Acodei syncs finalized Stripe invoices into QuickBooks Online, including the immediate invoices that interval switches create, and applies each payment to the invoice it paid. Start a free trial.
Automate your Stripe to QuickBooks sync
Save hours every month. Acodei automatically syncs your Stripe transactions, invoices, and payouts to QuickBooks Online.
14-day free trial · card required · cancel anytime
How Acodei handles this in your stack
Stripe QuickBooks Integration
See how Acodei syncs Stripe payments, fees, refunds, invoices, and payouts into QuickBooks Online automatically.
Or go straight to a capability
Advanced Product Mapping
Map Stripe products to QuickBooks with rule-based logic on product ID, price ID, metadata, and account. Set rule priority and extend mapping to refunds and fees.
Automated Invoice Sync
Bring Stripe invoices into QuickBooks and auto-apply payments and credit memos, with invoice numbering suffixes and quantity tracking to cut double-entry.
Multi-Currency Mastery
Sync Stripe transactions across currencies with automatic exchange rate handling and currency-specific customer records. Our team enables multicurrency on request, and zero-decimal currencies such as JPY are not supported.
Class Mapping
Map Stripe products to QuickBooks classes for scalable categorization and multi-entity reporting. Class tracking requires QuickBooks Online Plus or Advanced.
Historical Data Import
Backfill historical Stripe data into QuickBooks by month range. Preview volume and cost before syncing so reporting starts from a complete baseline.
How to Connect Stripe to QuickBooks Online
Connect Stripe to QuickBooks Online in minutes. Acodei links both accounts with secure OAuth and syncs payments, fees, refunds, and payouts automatically.
Reconcile Stripe Payments in QuickBooks
Reconcile Stripe in QuickBooks Online automatically. Acodei splits out fees, matches payouts to deposits, and keeps every charge audit-ready.
Related articles
Acodei Journal
Raising Prices on Stripe Subscriptions and QuickBooks
Acodei Content Team
Raising Prices on Stripe Subscriptions and QuickBooks
11/15/2026
Acodei Journal
Stripe Pending Invoice Items: Billing Between Renewals
Acodei Content Team
Stripe Pending Invoice Items: Billing Between Renewals
11/14/2026
Acodei Journal
Stripe Refund Processed as a Reversal: What QuickBooks Shows
Acodei Content Team
Stripe Refund Processed as a Reversal: What QuickBooks Shows
11/14/2026
Get more operational finance guides like this one
We will only send high-value product and finance content.