Shopify Marketplace

Learn how to list and manage your Pandium-powered integration on the Shopify Marketplace, including configuration steps, listing requirements, and best practices for a successful app listing.

When submitting your app to the Shopify marketplace, you'll need to include several critical values during the app creation process in your Shopify Dev Portal.

1. Scopes

Please note, the scopes you select during app creation determine which webhooks you can use. These scopes also need to match when you provision the Shopify connector in Pandium.

2. Redirect URLs

You would use the following URLs:

• Production: https://api.pandium.io/v0/author/callback/oauth2

• Staging: https://api.sandbox.pandium.com/v0/author/callback/oauth2

You also need to make sure you include your Landing URL in your redirect URLs.

3. App URLs

The OAuth Installation URL initiates the connection flow when users install your app from the Shopify marketplace. This URL is configured in the Shopify Dev Portal and is called by Shopify when a user installs your app.

Important: This URL cannot be accessed directly. It must be called by Shopify, which includes HMAC signature verification parameters. Accessing this URL directly will result in a 401 Unauthorized error.

Base URL Format

Choose the appropriate base URL for your environment:

Sandbox Environment:

https://exmart.sandbox.pandium.com/v1/shopify/auth/<account_name>/<integration_name>

Production Environment:

https://exmart.pandium.io/v1/shopify/auth/<account_name>/<integration_name>

Replace <account_name> and <integration_name> with your specific values.

Query Parameters

Add the following query parameters to your App URL:

landing_url (required)

• Specifies where users are redirected after completing the installation

• Pandium will append additional query parameters to handle tenant linking

• Format: ?landing_url=<marketplace_url>

  • Example: ?landing_url=https://gwtech.io..pandium.com/integrations

Reminder: Please include your landing URL in your redirect URLs

4. Uncheck "Embedded App in Shopify Admin"

At this time, Pandium doesn't doesn't support this feaure, so you need to make sure this is unchecked before submitting your application.

Uninstalling Your Shopify App

By default, we auto subscribe each shop that installs the integration to the Shopify uninstall webhooks. As a result, when you uninstall it from the Shopify dashboard, this will uninstall/archive the corresponding tenant in Pandium. When you uninstall your tenant from your Pandium marketplace, this will result in the app being uninstalled from the Shopify Dashboard.

Need Help?

If you encounter issues during the listing process, please feel free to contact your Pandium Technical Account Manager for assistance.