Creating a Shopify connection for Mergado Marketplaces#

This step-by-step guide explains how to create a Shopify app, set the required API permissions, and connect your Shopify store to Mergado Marketplaces for order synchronization.

If you want to use order import for Shopify, you first need to create a Shopify connection in Mergado Keychain.

If you already have a connection to Mergado via API through a “custom app” in the Shopify admin in Mergado Keychain, you just need to update the list of permissions for that app in Shopify as described below.

This guide strictly follows the official Shopify documentation and the current user interface for creating apps using the Shopify Developer Dashboard.

Official sources: https://shopify.dev/docs/apps/build/dev-dashboard/create-apps-using-dev-dashboard

You are creating a custom API app for one specific e-shop. The app does not need to be published to the Shopify App Store.

1. Creating an app in Shopify#

For Mergado Marketplaces to have API access to your Shopify account, you need to create an app with the required permissions:

a) Open the Shopify Developer Dashboard#

You can access the Shopify Developer Dashboard in two ways:

Option A: Direct access

1. Go to https://dev.shopify.com/
2. Log in with your Shopify account
3. Open the Apps section in the left menu

Option B: Via the Shopify admin

1. Open the Shopify admin of your e-shop
2. Go to Settings → Apps
3. Click on Develop apps
4. Click on Build apps in Dev Dashboard

b) Create a new app#

1. Make sure you are in the Apps section
2. Click on Create app
3. Choose Start from Dev Dashboard
4. Enter the app name (e.g., Mergado integration)
5. Click on Create

After creating the app, you will be redirected to the Versions tab.

c) Create an app version and set permissions (scopes)#

Every app must have at least one version to be installable in an e-shop.

d) Setting access permissions#

1. In the Access section, click on Select scopes
2. In the modal window, search for and check:

Required permissions for Mergado Marketplaces:

• read_customers + write_customers
• write_orders + read_orders
• read_products
• read_shipping + write_shipping
• write_order_edits + read_order_edits

And if you also want to import products into Mergado via API, add:

• write_products
• read_products
• read_markets

3. Confirm by clicking Done

e) Publishing (releasing) the version#

1. Scroll down on the page
2. Click on Release
3. In the confirmation window, you can leave the version name empty
4. Confirm by clicking Release

The app version is now published and ready for installation.

f) Install the app in your e-shop#

1. Open Home in the left menu
2. Click on Install app in the top right corner
3. Select the Shopify e-shop you want to connect with Mergado
4. You will be redirected to the Shopify admin
5. Confirm the installation by clicking Install

The app is now installed in your e-shop.

2. Connecting Shopify in Mergado Keychain#

To connect Shopify in Mergado Keychain, you need:

• Shopify URL:

  • Open the Shopify admin of the connected e-shop
  • Open Home in the left menu
  • In the Domains section, copy the e-shop URL
  • Example: your-store.myshopify.com

• Shopify API access key:

  • Return to the Shopify Developer Dashboard
  • Open your app
  • Go to Settings
  • In the Credentials section, copy the Secret value and paste it into Mergado Keychain

3. Activating orders in Mergado Marketplaces#

Go to the Orders > Activation section in Mergado Marketplaces, click on the Shopify icon, and save the changes. You can pause synchronization at any time on the activation page. Orders are synchronized every 5 minutes.

ℹ️ The order management system does not synchronize retroactively. So you don’t need to worry about your system being flooded with all previous orders when you start it.

Done! 🎉 From now on, orders will be regularly transferred between your marketplaces and Shopify.