How Does Shopify Handle Prorated Charges & Refunds When Changing App Subscriptions?

[qprtti_dev]

Hi, I’m working on setting up a subscription for my Shopify app using the Admin API’s appSubscriptionCreate mutation. I have a question regarding AppSubscriptionReplacementBehavior:

If a user already has an active subscription and I create a new subscription with AppSubscriptionReplacementBehavior: APPLY_IMMEDIATELY, what happens in these scenarios?

1.If the new subscription plan costs less than the existing one, does Shopify refund the user for the difference?

2.If the new subscription plan costs more, is the amount prorated based on the remaining billing cycle?

I couldn’t find a clear answer in the docs, so I’d appreciate any insights from those who have experience with Shopify subscriptions.

Thanks in advance!

[xiao91]

I had the same question, ive asked the Shopify support team and they directed me to the Shopify Dev team. But they are giving different weird answers.

1. They prorated value(Difference between old and new plan) are automatically applied and calculated by Shopify, but i am not able to see this in test environment. Maybe only works in production?

2. one of support team is telling me to add replacementBehavior: CANCEL_AND_BILL_PRORATED -> this is not a valud enum not sure why this was one of the answer given.

3. Need to apply the replacementBehavior, which i did and tried for all the 3 enum values none of it works. Still haven't got a clear answer from them.