> ## Documentation Index
> Fetch the complete documentation index at: https://docs.chift.eu/llms.txt
> Use this file to discover all available pages before exploring further.

# Shopify

# **PREPARATION**

1. Identify the technical name of your "store" on Shopify

<img src="https://mintcdn.com/chift/_YxvhDmjdQeIESjC/images/help/shopify/shopify-1.png?fit=max&auto=format&n=_YxvhDmjdQeIESjC&q=85&s=ed92e0e76858d7a76248e68be8db7191" alt="" width="1276" height="1394" data-path="images/help/shopify/shopify-1.png" />

# CONNEXION

**Step 1:** Choose a name for your connection (informative).

<img src="https://mintcdn.com/chift/5FvfVbGwKHoQNfh9/images/help/shopify/shopify-2.png?fit=max&auto=format&n=5FvfVbGwKHoQNfh9&q=85&s=392c95f91b7927212f8ddecf87bf6829" alt="" width="596" height="111" data-path="images/help/shopify/shopify-2.png" />

**Step 2:** Enter the technical name of your store, previously found on your account.

<img src="https://mintcdn.com/chift/5FvfVbGwKHoQNfh9/images/help/shopify/shopify-3.png?fit=max&auto=format&n=5FvfVbGwKHoQNfh9&q=85&s=5ef5bbef14a27b7474f165a22d4ace7b" alt="" width="591" height="111" data-path="images/help/shopify/shopify-3.png" />

**Step 3** : (**Optional**) Enter the client id / client secret of your app. If you are asked for this please move to section "**Configuration - Custom app**" below in this guide. Otherwise continue to **step 4a.**

<img src="https://mintcdn.com/chift/5FvfVbGwKHoQNfh9/images/help/shopify/shopify-4.png?fit=max&auto=format&n=5FvfVbGwKHoQNfh9&q=85&s=1a6988b7305c178904173c5a350113b1" alt="image.png" width="962" height="142" data-path="images/help/shopify/shopify-4.png" />

<img src="https://mintcdn.com/chift/5FvfVbGwKHoQNfh9/images/help/shopify/shopify-5.png?fit=max&auto=format&n=5FvfVbGwKHoQNfh9&q=85&s=202ecb9e147315f1b91d11415f3aa72b" alt="image.png" width="970" height="136" data-path="images/help/shopify/shopify-5.png" />

**Step 4a:** Click "Authorise" to finalise the connection.

<img src="https://mintcdn.com/chift/5FvfVbGwKHoQNfh9/images/help/shopify/shopify-6.png?fit=max&auto=format&n=5FvfVbGwKHoQNfh9&q=85&s=5eb77d5f95975ee0a8427bcf3c0bd053" alt="" width="118" height="47" data-path="images/help/shopify/shopify-6.png" />

**Step 5a:** Choose your Shopify store to connect

<img src="https://mintcdn.com/chift/5FvfVbGwKHoQNfh9/images/help/shopify/shopify-7.png?fit=max&auto=format&n=5FvfVbGwKHoQNfh9&q=85&s=122c3f4b15b12e0cc526cbe1cf237999" alt="" width="1600" height="1153" data-path="images/help/shopify/shopify-7.png" />

**Step 6a:** Install the app of your partner you wish to connect with Shopify.

<img src="https://mintcdn.com/chift/5FvfVbGwKHoQNfh9/images/help/shopify/shopify-8.png?fit=max&auto=format&n=5FvfVbGwKHoQNfh9&q=85&s=7b9d9617058f3412cd63c2cd235d4f13" alt="" width="1600" height="768" data-path="images/help/shopify/shopify-8.png" />

<img src="https://mintcdn.com/chift/5FvfVbGwKHoQNfh9/images/help/shopify/shopify-9.png?fit=max&auto=format&n=5FvfVbGwKHoQNfh9&q=85&s=a6c63fb842b7ec8e988306b49fa56748" alt="" width="1600" height="613" data-path="images/help/shopify/shopify-9.png" />

### Configuration - custom app

Proceed with those steps only if you are asked for a client id and client secret.

**Step 4b:** Go to the Dev Dashboard ([https://dev.shopify.com/dashboard](https://dev.shopify.com/dashboard)) and follow the steps outlined in this article to activate and create a custom app:

* [https://shopify.dev/docs/apps/build/dev-dashboard/create-apps-using-dev-dashboard](https://shopify.dev/docs/apps/build/dev-dashboard/create-apps-using-dev-dashboard)

  * The following scopes are needed:

    * read\_orders
    * read\_all\_orders (if you need to retrieve orders older than 60 days). Note that if you are creating the app as a partner of the merchant, you will need to retrieve extra access through the partner dashboard, see the documentation: [https://shopify.dev/docs/api/usage/access-scopes#orders-permissions](https://shopify.dev/docs/api/usage/access-scopes#orders-permissions). Once this is done, you will be able to see "read\_all\_orders" in the scopes available (refresh the page if needed)
    * read\_returns
    * read\_discounts
    * read\_products
    * read\_customers
  * The redirection url is the following "**[https://chift.app/oauth2/redirect](https://chift.app/oauth2/redirect)**".
* You don't have to install the application.

Here are a few screenshots outlining the steps:

<img src="https://mintcdn.com/chift/_YxvhDmjdQeIESjC/images/help/shopify/shopify-10.png?fit=max&auto=format&n=_YxvhDmjdQeIESjC&q=85&s=a1bbb50c5b0f43a40dacec4e504661fa" alt="image.png" width="1600" height="503" data-path="images/help/shopify/shopify-10.png" />

<img src="https://mintcdn.com/chift/_YxvhDmjdQeIESjC/images/help/shopify/shopify-11.png?fit=max&auto=format&n=_YxvhDmjdQeIESjC&q=85&s=f9c6bfe5abf9358a83c637366125b27f" alt="image.png" width="1600" height="344" data-path="images/help/shopify/shopify-11.png" />

<img src="https://mintcdn.com/chift/5FvfVbGwKHoQNfh9/images/help/shopify/shopify-12.png?fit=max&auto=format&n=5FvfVbGwKHoQNfh9&q=85&s=b4044ac2417afc5e6a306e39bb309573" alt="image.png" width="1582" height="1538" data-path="images/help/shopify/shopify-12.png" />

<img src="https://mintcdn.com/chift/5FvfVbGwKHoQNfh9/images/help/shopify/shopify-13.png?fit=max&auto=format&n=5FvfVbGwKHoQNfh9&q=85&s=c9a7bc6647957d42be3b4e11c0e3c362" alt="image.png" width="1570" height="1550" data-path="images/help/shopify/shopify-13.png" />

**Step 5b:** Click on "Settings" in the menu on the left. Copy the "Client id" / "Secret"

<img src="https://mintcdn.com/chift/5FvfVbGwKHoQNfh9/images/help/shopify/shopify-14.png?fit=max&auto=format&n=5FvfVbGwKHoQNfh9&q=85&s=23ebef98ed385cf7bb8c092f320eeff2" alt="image.png" width="1600" height="569" data-path="images/help/shopify/shopify-14.png" />

**Step 6b:** Paste the client id / client secret in the respective fields and click on "Authorise". You will be redirected and asked to install the application. Please proceed for a successful installation.
