--- title: "Upgrade guide — v21 to v22 — Subscriptions" source: https://support.storeconnect.com/articles/upgrade-guide-v21-to-v22-subscriptions type: article format: markdown site: StoreConnect Support — product and developer documentation for StoreConnect site_index: https://storeconnect.com/llms.txt docs_index: https://support.storeconnect.com/llms.txt note: Append .md to any page or article URL on this site to get its Markdown form. --- # Upgrade guide — v21 to v22 — Subscriptions Skip this section if you do not use StoreConnect subscriptions. The guide assumes you are on the latest v21 website release. Changes that already shipped in v21 patch releases are not repeated here. ## Behavior changes ### Review: Fixed-term subscriptions paid upfront are charged their term once This applies only if you sell a product that is both a fixed-term subscription and paid upfront. Previously the line was priced as though the upfront period commitment and the fixed term compounded, so a 12-term product committing 6 periods was charged for 72 terms. A fixed-term line paid upfront is now charged its full term and nothing more, and renewal pricing divides by the same count the cart used. 1. Place a test order for each fixed-term, paid-upfront product and confirm the cart total matches the price you intend. 2. If customers were overcharged on earlier orders, review those orders and decide whether to refund the difference. ### Review: Renewal order items are created before charging Renewal order items are now created before the subscription is charged, and a partially paid renewal order is charged its outstanding balance rather than the full amount. If you have Flows that populate renewal orders, confirm after upgrading that a renewal produces one subscription line. ### Review: Plan-change orders complete like renewal orders When a customer changes plan, the plan-change order is now finalized and completed the same way a renewal order is, so order completion automation, confirmation emails, and downstream syncs run for it. If you have Flows on order completion that should not fire for plan changes, review them. ### Review: Pay Later subscriptions keep their setting after a one-off payment A payment on an existing subscription's order through the payment link or a Salesforce payment no longer switches a Pay Later subscription back to automatic charging. Only a charge that saves a reusable payment token updates the subscription's payment details. ### Review: Customers can pay a renewal order without signing in When the `subscriptions.guest_renewal_payment_enabled` store variable is `true`, a pending renewal order can be paid in full through the additional payment page without logging in, for example from a link in a renewal email. The payment advances the subscription the same way an automated charge does and never changes the stored payment token. The variable is off by default, so nothing changes until you set it. ### Review: Subscriptions sold at the POS capture a card This applies only if you sell subscription products at the POS. A cart containing a subscription or save-card product now requires an identified customer. When a Square Terminal is paired, the POS inserts a **Save card for subscription** step at checkout; otherwise a web page is offered to capture the card. The captured card is verified against the gateway, stored as a `Payment_Method__c` record, and linked to the order's subscriptions. Preauthorize-only products cannot be sold at the POS. Recurring billing is unchanged. ### Review: Saved payment methods in the account area Customers on Stripe, Stripe ACH, or Square can save a card in the account area. Saved methods are not bound to a subscription for renewal. Renewals continue to use the subscription's own stored token and provider. See [Payment methods](payment-methods). --- ## Follow StoreConnect - [Email Newsletter](https://storeconnect.com/c/lp-newsletter) - [LinkedIn Newsletter](https://www.linkedin.com/build-relation/newsletter-follow?entityUrn=7444956928444862464) - [YouTube](https://www.youtube.com/channel/UCngKdP2x8l1wcbAKW3tvU8g) - [LinkedIn](https://www.linkedin.com/company/storeconnect) - [X / Twitter](https://x.com/storeconnecthq) ## Popular Links - [Partners](https://storeconnect.com/partners) - [Become a Partner](https://storeconnect.com/become-a-partner) - [News](https://storeconnect.com/articles/news) - [Events](https://storeconnect.com/articles/events) - [Feature Comparison](https://storeconnect.com/how-we-compare) - [Download a free trial](https://appexchange.salesforce.com/appxListingDetail?listingId=a0N3A00000FMkeKUAT) - [Book a Demo](https://storeconnect.com/contact) ## Documentation - [Help documentation](https://support.storeconnect.com/help-documentation) - [AI agents](https://support.storeconnect.com/ai) - [Videos & tutorials](https://support.storeconnect.com/videos-tutorials) - [Developer reference](https://support.storeconnect.com/developer-reference) - [Release notes](https://support.storeconnect.com/release-notes) - [Troubleshooting](https://support.storeconnect.com/troubleshooting) - [Trust Center](https://trust.getstoreconnect.com/) - [Status Page](https://status.storeconnect.com/) ## Contact - info@getstoreconnect.com - US +1 415 745 3230 - AUS +61 2 8365 2308 100 S Ashley Dr, Suite 600-2461 Tampa FL 33602-600 USA Level 22, Sydney Place 180 George Street Sydney, NSW, 2000, AUS ## Machine-readable - [Site index for agents](https://storeconnect.com/llms.txt): curated map of the StoreConnect site in llms.txt format - [Documentation index for agents](https://support.storeconnect.com/llms.txt): full technical and product documentation map Every page and article on this site has a Markdown rendering: append `.md` to its URL. Continue in Markdown: [Help documentation](https://support.storeconnect.com/help-documentation.md) · [Developer reference](https://support.storeconnect.com/developer-reference.md) · [Videos & tutorials](https://support.storeconnect.com/videos-tutorials.md) · [Release notes](https://support.storeconnect.com/release-notes.md) --- StoreConnect Support — https://support.storeconnect.com/articles/upgrade-guide-v21-to-v22-subscriptions