Shopify billing API guides offer no guidance on how to monitor cancelled subscriptions and what’s the best approach.
At first, we opted to the “app/uninstall” webhook initially and thought this would be a solution.
We later found out that RecurringCharges will be frozen if a user “frozen” his store which can be found using the “shop/update” webhook and checking the **plan_name** in the payload.
Later we found out that **plan_name** is not documented fully and can have many values that symbolize a closed store, e.g.
frozen
cancelled
dormant
fraudulent
And we probably missed a few more.
We also found the “app_subscription/update” webhhook but there is no documentation for this one whatsoever and it seems it’s not implemented yet.
Eventually, it seems the only option right now to identify if a RecurringApplicationCharge is cancelled with 100% certainty is by polling the API with a CRON which is not very efficient or simple.
Thanks, but as mentioned there are many undocumented possible values for Shop’s plan:
frozen> cancelled> dormant> fraudulent
And the shop/update webhook does not tell us if the merchant will be billed for your app in the future or not.
Unless you can specify how to do it better?
This is exactly what the post is about - there’s no documentation about how to handle subscription cancellations other than manual cancellations or uninstall of the app.
I agree with poster. It is extremely difficult on our end to sync up reliably with who actually has an active shopify subscription in a bulk fashion. It does seem the only “reliable” way is to iterate over all users on our end and query the shopify api billing system. Curious as to how anyone else is managing this on their end.
Strongly agree with the poster. We spent SO much time, trying to understand all the scenarios.
After doing that we subscribed to the appSubscriptionUpdate webhook, however, it seems we’re not getting ANY of the expected notifications there when the shop updated the plan.
There is no documentation as to when this will fire, how the data is expected to look like, or anything at all basically. This is very frustrating…
This is what we came up with:
Canceled - The shop is closed permanently. Recurring application charges are removed. Partners must create new recurring application charges if the store re-opens.
Frozen - The shop is paused temporarily. Recurring application charges become inactive but remain in the store. The recurring application charges will resume after the store is unfrozen.
Dormant - Open with no orders, usually temporarily. Recurring application charges stay active and are charged normally
Fraudulent - Shop has been closed (can be permanent or temporary). Probably like “canceled”.
Shopify staff can we please get an update on this? Clarification on plan_name has been asked again and again without sufficient responses from staff. This isn’t something that partners can figure out on our own and this is internal knowledge that isn’t publicly documented.
This post also asked for a full list of plan_name values. No response from shopify staff and it was asked four years ago. Other Shopify partners tried their best to crowd source the various values but without context as to what plan_name can mean, it doesn’t really help us.
Shopify Staff, please help us write better software for merchants. Tell us something, even if it’s just that there are no plans to document plan_name at this time. It would be disappointing but still less frustrating than the silence.
Thanks for the repost here. I know this is an old thread, but I’m happy to discuss.
As it relates to app billing, can you share the reason the plan is needed? I know a lot has been discussed already, but the reason I’m asking is because when a shop is changed to any of the inactive states, unless the app is uninstalled; if the store plan is re-activated, the current app subscription will resume until the merchant uninstalls the app.
