Migration API
The Migration API will move existing subscriptions to Shopify App Pricing when they can't migrate through the plan setup flow. Use it for subscriptions that don't map cleanly to one of your new plans, such as usage-based subscriptions or subscriptions whose current price doesn't match a plan you've created.
The Migration API isn't available yet. This page describes what the API will do so that you can plan ahead. Setup steps and reference documentation will be added when the API is released.
The Migration API isn't available yet. This page describes what the API will do so that you can plan ahead. Setup steps and reference documentation will be added when the API is released.
Anchor to When to use the Migration APIWhen to use the Migration API
The plan setup flow moves subscriptions that map directly to a Shopify App Pricing plan, where the current price and billing terms match a plan that you've prepared.
Some subscriptions can't move that way:
- Usage-based subscriptions, which bill on metered usage rather than a fixed recurring price.
- Price mismatches, where a subscription's current price doesn't match any of your Shopify App Pricing plans.
The Migration API will let you move these remaining subscriptions to Shopify App Pricing. Until it's available, these subscriptions keep billing as usual on their current plans, and you don't need to take any action.