Enumeration of plan_name from GET /admin/shop.json

[Zac12]

Howdy all,

Looking for an enumeration (list of all available options) of plan_name when you're doing a GET request to the /admin/shop.json

I've noticed that there a few, with a subset of others?

For example:

Trial:
trial

Trial from Partner:
affiliate

Basic Shopify:
basic

Shopify:
professional

Advanced Shopify:
unlimited

Shopify Plus (Enterprise):
enterprise

Are there any others?

Also, shopify documentation team, I'd really appreciate this being documented in your documentation _somewhere_.

Much appreciated

[Zac12]

There are more!

custom

singtel_basic

singtel_unlimited

dormant

Cheers

[Zac12]

More, again.

Submitted an application for beta testing -- Shopify staff shops have the plan_name of "staff".

[ClementG]

Same question here.

Does anyone from Shopify care to give us the full list here?

In my case, I use the analytics api but this is not available for all plans and I want to let the user know that depending on their plan...

[ClementG]

Thanks Zac for looking into this.

Did you figure out if trial shops have the same permissions as the advanced plan?

[Zac12]

Hey Clement,

Shopify don't seem to be super helpful in terms of giving plan names away. I'll find the email chain once I get back into the office on Monday. From what tests I have done, trial and affiliate plans both have the access rites of the Advanced plan. As in, access to all analytics etc.

[ClementG]

I see.

This should definitely be documented somewhere IMO, even if it may change in the future...

[Zac12]

Hey Clement,

Here's a copy of an email from Josh @ Shopify.

Hi Zac,

Josh here from the Shopify developer relations team. Thanks for reaching out :)

We don't provide a complete list of values for that field, but I can give you some of the common ones: 
professional, npo_lite, custom, grandfather, unlimited, staff, affiliate, trial, dormant, npo_full, basic, comped, starter, business, frozen, shopify_plus

Hope this helps!

Josh @ Shopify

[ClementG]

Thanks for that Zac.

Some of those names are really not very descriptive here. (npo_lite, singtel_basic...)

And If I understand there is 'enterprise' and also 'shopify_plus' for the same Plus plan...

As far as API permission, I wonder if the easiest thing to do is to try do an API call and see if it succeeds! (Rather than relying on the plan name...)

[Zac12]

That sounds like the best idea in terms of knowing instantly.

Doesn't really work for my main issue though, that a biling api sent to a trial store throws a error and takes the user both out of the app and out of their store backend.

[ClementG]

Hmm that's no good.

Do you mean when you try to issue a recurring charge? I was able to do it on trial accounts, but I only used test charges so far...

[Zac12]

Just non-test charges.

Set up a lot of logic which simply checks the plan name they have, and if it's affiliate or trial -- send them to a page requesting they upgrade their plan before trying to do something specific, like upgrading the app package etc.

[ClementG]

Hmm I see. I will have to implement something similar...

[Zac12]

The way I've implemented this is by having middleware which is queried every request after the user has completed the install procedure for the app.

If the store plan matches one of the trial types, set a value in REDIS for their store to say that they are a trial user with a 30 minute timeout (in case they upgrade, but also doesn't hammer the shopify api limiter).

If the store isn't -- redirect them to the payment page which redirects them to the "pls confirm payment" thing in Shopify. Once they have done that, set a value in REDIS to say that this store has payed. On uninstall remove the REDIS key so they don't get no free 30 minutes of app usage etc.

Then the middleware just checks to see if this key exists in redis, otherwise normal query stuff.

Trial users I've blocked from upgrading the app plan, they just get redirected to the upgrade store plan page as said above.

[ClementG]

I see thanks

[joyrexus]

Apparently cancelled is another possible value.

These values really need to be documented.  App developers need to know what these values imply, esp, the causes and consequences of the values frozen, cancelled, and dormant.

For apps that need to keep an accurate track of a shop's purchase history, I believe the plan_name attribute in the shop/update webhook callback is the only thing that could be used to reliably trigger a disconnect process.

[Bogdan_Radu]

I checked our database to see what values we have and this is what i found: 

"affiliate",
"staff",
"professional",
"custom",
"shopify_plus",
"unlimited",
"basic",
"cancelled",
"staff_business",
"trial",
"dormant",
"frozen",
"singtel_unlimited",
"npo_lite",
"singtel_professional",
"singtel_trial",
"npo_full",
"business",
"singtel_basic",
"uafrica_professional",
"sales_training",
"singtel_starter",
"uafrica_basic",
"fraudulent",
"enterprise",
"starter",
"comped",
"shopify_alumni"

[AryeeBernard]

The information provided above will be more useful if we knew what the plan_names translated to, and how if affects a developer

[Michal17]

Hi @Bogdan_Radu 

Hope you're having a great day!

---

@Bogdan_Radu wrote:

I checked our database to see what values we have and this is what i found: 

"affiliate",
"staff",
"professional",
"custom",
"shopify_plus",
"unlimited",
"basic",
"cancelled",
"staff_business",
"trial",
"dormant",
"frozen",
"singtel_unlimited",
"npo_lite",
"singtel_professional",
"singtel_trial",
"npo_full",
"business",
"singtel_basic",
"uafrica_professional",
"sales_training",
"singtel_starter",
"uafrica_basic",
"fraudulent",
"enterprise",
"starter",
"comped",
"shopify_alumni"

---

Thanks a lot.

[Michal17]

---

@Michal17 wrote:

Hi @Bogdan_Radu 

Hope you're having a great day!

---

@Bogdan_Radu wrote:

I checked our database to see what values we have and this is what i found: 

"affiliate",
"staff",
"professional",
"custom",
"shopify_plus",
"unlimited",
"basic",
"cancelled",
"staff_business",
"trial",
"dormant",
"frozen",
"singtel_unlimited",
"npo_lite",
"singtel_professional",
"singtel_trial",
"npo_full",
"business",
"singtel_basic",
"uafrica_professional",
"sales_training",
"singtel_starter",
"uafrica_basic",
"fraudulent",
"enterprise",
"starter",
"comped",
"shopify_alumni"

---

Thanks a lot.

---

https://community.shopify.com/c/Shopify-APIs-SDKs/Closing-pausing-store-webhook/m-p/1207244/highligh...

List updated

[Manaspaul623]

Hi there,

 looks like another plan name exist. "partner_test"