I'm stuck on handling app charges in store reinstalling our app. In docs (e.g. here and here) it stands, that I should handle app reinstallation that occurs in the same app billing cycle that uninstall occured (for example by creating application credits). But I found the API announcement which says, that the case is handled by Shopify and the charge will be proportionally lower after app reinstallation. What is current behavior in API v 2019-10 and 2020-01?
Shopify indeed handles prorating when a merchant uninstalls and reinstalls your app during the same billing cycle. You don't have to do something about it, unless you have (as one of the articles you mention says) e.g. free trial and you want to readjust it for the days the merchant had the app uninstalled.
Edit: please see my clarification below. There is no prorating for the same billing period if a merchant uninstalls and reinstalls the app in general. The prorating the API article mentions fixes the possibility of double charging the merchant.
Hope I helped :)
Hi again @kpusmo
The API announcement post is quite accurate:
Added this comment just to clarify that in the first case (no trial period) the merchant will not be charged only for 20 out of 30 days for example, but the full recurring charge.
Thank you @AskBeat
To clarify, I have two scenarios:
In case our app has 10 trial days, and merchant:
Will the merchant be charged just like he never uninstalled the app (as there is no trial period after the second installation)?
And another scenario:
In this scenario new app billing cycle will be created (from 25th till 30 days from 25th) - but how would a merchant be charged for the first cycle? Will he be charged for period from trial end to cycle end? Or would he be charged for $0 for 5 days of free trial?
Your scenario is indeed more complex (with offering and consuming trial periods), it would be nice to have the feedback from Shopify here, as the documentation resources might be interpreted in many ways.