Integrate Shopify with JMango360

Integrate Shopify with JMango360

This article explains how to integrate your Shopify store with JMango360: installing the JMango360 apps, giving us access to your store backend, and the information we need to validate your app. It also covers the optional App Exclusive Promotions setup for stores on Shopify Plus.

Setup checklist

TaskNeeded?Section
Install JMango360 Mobile App BuilderRequired2.1
Install the Headless appOnly if you use one-time login codes2.2
Set up JMango360 App PromotionsOptional, Shopify Plus only2.3
Add support@jmango360.com as staffRequired3
Share coupon codes and customer group information, assign products to the sales channelRequired (customer groups only if you use them)4

1. About Shopify integration

One of the core functionalities of the JMango360 offering is the in-depth and seamless integration with Shopify. The mobile app fetches data directly from the Shopify admin and interacts with Shopify via the API.

The following information is fetched from Shopify:

  • Customers: Data sets related to customers, customer groups and segments, and storefront sign in
  • Catalog: Data associated with product management, variants, brands, stock, bulk pricing, and more
  • Carts and orders: Information on cart and order experiences
  • Webhooks: The synchronization of critical events related to products and orders

Here are some key benefits that you, as a merchant, can gain from the integration with Shopify:

  • You can manage your product information, including stock information, inventory, and customer data in one place.
  • The integration eliminates the need for extensive custom coding, resulting in cost savings related to development resources and maintenance.
  • It is easier for you to iterate and make updates to the app, especially if you need to respond quickly to changing market trends, update product catalogs, or introduce new features to stay competitive.

In addition, the integration is also beneficial to your customers. The shopping session between the website and the app will be aligned, ensuring a seamless experience for customers. They can enjoy a consistent and seamless shopping journey between the website and the app.

2. Install the JMango360 apps

Depending on the features you use, one to three JMango360 apps are installed in your Shopify admin.

2.1 JMango360 Mobile App Builder (required)

Step 1: Open JMango360 Mobile App Builder via this link and login to your Shopify Account

Step 2: On the app page, click Install.

Step 3: In your Shopify admin, to authorize the use of the app, click Install.

Step 4: Once the app is installed, you can view and use it from the Apps page in your Shopify admin.

2.2 Headless app (only for one-time login codes)

If you choose the customer account set up with a one-time login code in the Shopify backend, you need to install the Headless app. After installing, please share the required store access (admin or collaborator) with the JMango360 team. This access will allow us to complete the integration of the Login with Code feature into your app.

2.3 JMango360 App Promotions (optional, Shopify Plus only)

App Exclusive Promotions let you offer discounts that only your mobile app users can get, giving shoppers a reason to download, keep and buy through your app. The discounts run on Shopify Functions through a custom app, JMango360 App Promotions, which the JMango360 team deploys into your store.

⚠ Before you start: your store must be on a Shopify Plus plan. This is a Shopify requirement for custom apps that use Shopify Functions.

Step 1: Create an empty app in the Shopify Developer Dashboard

  1. Log in to your Shopify Developer Dashboard.
  2. Select Apps in the left panel, then click Create app in the top right corner.
  3. Choose Start from Dev Dashboard.
  4. Enter a name for the app and click Create.
⚠ Important: please stop here. Do not release a version, set API scopes or choose a distribution type. Our deployment configures all of this automatically; settings made beforehand create conflicts that we have to reset.

Step 2: Create the deploy token (service account)

Shopify now creates the deploy token through a service account in your organization. The token only allows us to deploy to the app you choose. It cannot access anything else in your store. Log in with an account that can manage apps (the store owner always can).

  1. Go to dev.shopify.com/dashboard, click Apps, then click the app you created in Step 1.
  2. In the app's left menu, click Settings. Scroll down to App CLI automation token and click Manage. Your Shopify admin opens on Settings → Users → Security.
  3. Under Organization service accounts, click Add service account.
  4. Fill in the form:
    • Name: JMango360 deploy
    • Expiration: 6 months
    • Permissions: keep App development ticked and choose your app (from Step 1)
    • Leave Dev store management empty
  5. Click Add service account at the top of the page.
  6. Copy the access token (it starts with atkn_). Shopify shows it only once. If you lose it, click Rotate on the same page and copy the new one.
If something is missing
  • No Manage or Add service account button? Your account can't manage apps. Please ask the store owner.
  • Your app isn't in the list? You're in another organization. Switch organization at the bottom left of the Dev Dashboard. The app must be in the same organization as your store; otherwise it can't be installed on it.

Renewing the token: the token expires after 6 months. Go to Settings → Users → Security in your Shopify admin, click the JMango360 deploy service account, click Rotate, and send us the new token.

Step 3: Share your details with us securely

Send us these three details:

  1. Deploy token (from Step 2, starts with atkn_)
  2. Client ID (at the top of your app's Settings page in the Dev Dashboard)
  3. Your store's permanent URL, e.g. your-store-name.myshopify.com
⚠ Security: the deploy token is sensitive. Please share it through a secure private link (such as a password manager's secure note), not by plain email or chat.

Step 4: Install the app after we confirm the deployment

Our team deploys the code into your app; no action is needed from you in the meantime. Once we confirm the deployment is complete:

  1. Log in to your Shopify admin and go to Settings → Apps.
  2. Find JMango360 App Promotions and click Install.
  3. After installation, the app page shows its Functions as active and Available for Discounts.

JMango360 App Promotions app page in Shopify admin

Shopify shows the message "This app is not listed in the Shopify App Store". This is expected, as it is a custom app built only for your store.

Step 5: Create your App Exclusive Discount

  1. In your Shopify admin, go to Discounts and click Create discount.
  2. Select JMango360 App Promotions as the discount type.
  3. Set the discount value, eligibility and usage limits, then click Save discount.

Select discount type dialog with JMango360 App Promotions

Step 6: Update your mobile app

A new build of your mobile app is needed for the promotion to work. The new version adds a cart attribute (jmango-mobile-app) to every shopping cart, which Shopify Functions check to unlock the app-only discount. Users on older app versions can't see or use the discount until they update.

⚠ Important: please contact the JMango360 team to build and publish the app update to the App Store and Google Play before you launch your promotion.

3. Provide Shopify backend access

Your website's backend access is required in order for us to do your app's integration. Please provide us with access to some administration areas of your website backend. Please be well noted that we require no access to anything related to the sales of your website. While testing the app, we assume that our test orders work well once we receive order confirmation emails.

Please add email support@jmango360.com as a collaborator and assign a custom set of permissions to it.

Step 1: Log in to the Shopify backend. Click on the Settings button at the bottom left to open the Settings window:

Step 2: On the menu side, choose Users and permissions. Then click on the button Add staff.

Step 3: Provide information as required. Make sure the Email address is set to support@jmango360.com.

Step 4: Select the permissions as shown below.

Step 5: Click Send invite to send the invitation. JMango360 will receive an email shortly after creating the account asking us to confirm our email address and create a password.

Additionally, you should grant access to specific Storefront API scopes if you are using app extensions on your Shopify store and want their functionality available in the mobile app.

Follow these steps:

  • Go to Apps and sales channels → Develop apps → select your Custom app → Configuration.
  • In the Settings panel, click Edit under Storefront API integration.
  • Enable and share the required permissions with us by selecting the checkboxes for the following fields:

4. Other requirements

4.1 Share coupon codes

Coupon codes are needed for the checkout process and testing purposes during the app development process, so you are expected to provide us with your coupon codes. With the coupon codes shared, we can conduct thorough testing and verification of the coupon-related features and ensure that the coupon codes are functioning correctly and delivering the intended outcomes.

Step 1: In the Shopify backend, create a coupon code for 20% discount.

Step 2: Share the coupon code with support@jmango360.com.

If you set up App Exclusive Promotions (section 2.3), please also share one app-only discount so we can test it in the new app build.

4.2 Share information about customer group

If you're using customer groups in Shopify and want to have this supported in the app we need to have information about the user group logic and access to each user group to complete our analysis and testing processes.

Step 1: Confirm if you're using Customer Groups. If yes, share information about your user groups, logic and rules.

Step 2: Use the following email addresses to add JMango360 to each user group:

4.3 Assign products and collections to the Sale channel JMango360 Mobile App Builder

To ensure that your products and collections appear in your mobile app, they must be assigned to the JMango360 Mobile App Builder sales channel. This step is essential for syncing product data between your e-commerce store and the mobile app.

Follow the steps below to update product visibility in bulk:

  • Log in to your Shopify Admin
  • Navigate to Products > All products
  • Use filters or search to find the group of products you want to update
  • Use the checkboxes to select multiple products (Tip: Click the top checkbox to select all products on the page)
  • Click the Bulk actions dropdown (top of the list)
  • Choose: Include in sales channels > JMango360 Mobile App Builder.
  • Wait for the confirmation message to ensure the action was applied successfully

If you have any further questions regarding the app builder, we're happy to help! Please reach out to us at customer.success@jmango360.com.