Creating a Shopify Connection for Mergado Marketplaces

Apps Mergado Marketplaces
1

If you wish to enable order import from Shopify, you first need to create a connection to Shopify in Mergado Keychain.

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

1. Creating an app in Shopify

In order for the Mergado Marketplaces API to access your Shopify account, you must create an app with the required permissions:

  1. Log in to your Shopify administration.
  2. Navigate to Settings > Apps & sales channels.

image
image920×560 49.1 KB

  1. Click on Develop apps in the top right corner.
  • Note: If creating custom apps is not yet enabled, click on “Allow custom app development”, read the warning and information shown, then click “Allow custom app development”.
  1. Click Create an app and fill in the details.

image
image1470×794 93.1 KB

  1. In the Overview tab, click on Configure Admin API scopes, select the scopes as specified below, and save changes.
  • 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:
    • read_products
    • read_markets
  1. Click Install app in the upper right, then in the modal window click Install.

image
image935×408 40.9 KB

  1. After installation, in the Admin API section under API credentials > Admin API access token, click Reveal token to display the access token. Keep this token safe, as you will need it for the Shopify connection in Mergado Keychain.

:warning: Note: The token will only be displayed once!

2. Connecting Shopify in Mergado Keychain

image
image1460×787 36.9 KB

For the Shopify connection in Mergado Keychain you will need:

  • Shopify URL:
    • Log in to your Shopify admin.
    • Look at the browser address bar.
    • The URL will be in the format: https://admin.shopify.com/store/{store-name}/…
    • Extract the store identifier {store-name}.
    • The resulting URL to enter is then store-name.myshopify.com
  • Access key to Shopify API: here you paste the Admin API access token that you copied from Shopify admin as described above.

3. Activating orders in Mergado Marketplaces

Go to Orders > Activation in Mergado Marketplaces, click the Shopify icon and save your changes. The synchronization can be paused anytime on the activation page. Orders are synchronized every 5 minutes.

:information_source: The order management system will not sync past orders. So you don’t need to worry about your system being flooded with all previous orders when you enable the connection.

That’s it! :tada: From now on, orders will be transferred regularly between your marketplaces and Shopify.