Our app bills through Shopify App Pricing. We recently added a usage meter to a plan that merchants were already subscribed to: a graduated meter with the first units of each cycle free, then a small per-unit price above that.
Partner support confirmed what the docs say: editing a plan does not change existing subscription contracts. Each merchant on the old version of the plan keeps a contract with no meter item, so their usage can never be billed. Support said the merchant would “select the plan again” on the plan selection page to get the updated terms.
We tested that and it does not work, so I am looking for the supported path.
What we tested
On a development store, with a private copy of the plan on our development app:
- The store subscribed to the plan before the meter existed. The Partner API
activeSubscriptionread showed one flat-rate item and no meter item. - We added the meter to the plan in the Partner Dashboard. The plan selection page then showed the merchant’s plan as “Current” with the usage tiers listed on the card, but with no button. Nothing on the page lets the merchant approve the new terms of the plan they are already on. A second
activeSubscriptionread was identical to the first: the contract was unchanged. - The only way to get the meter onto the store was to select a different plan and then select this plan again. That created a new contract, which now carried the meter item, and it also started a new trial on the test store.
- Changing the meter’s per-unit price later changed the plan card and nothing on the contract.
So for every merchant who subscribed before the meter went on, the meter is invisible to billing until they go through a plan switch and back, with whatever proration, cycle reset and trial handling that implies.
Questions
- What is the supported way to put the current version of a plan, meter included, onto an existing App Pricing contract? Is there a way to ask a merchant to approve updated terms for the plan they are on, given the plan page marks it “Current” with no action?
- If we delete the plan and recreate it with the same name and handle, does the page then offer it to existing subscribers as a selectable plan? Does that affect the App Store listing or trigger a review? Is delete-and-recreate the intended way to handle a pricing or usage charge change on a plan with subscribers?
- When a merchant approves a fresh contract for the same plan mid-cycle, does Shopify prorate the recurring fee, does a new billing cycle start that day, and does the trial-day tracking prevent a second trial?
- The new subscription migration tooling (
shopify app subscription-migrations) is documented for moving Billing API subscriptions onto App Pricing. Can it also take an App Pricing contract as a source, so an existing contract moves to the current plan terms at its next cycle without re-approval?
Has anyone shipped a meter or a price change on a plan with existing App Pricing subscribers? What did you do for the merchants who were already on it?