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.