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

# Connect Shopify Payments

This guide explains how to connect a store using **Shopify Payments** to Hurry and sync products correctly between both stores.

Before you start, **make sure the store you're connecting has its own domain set up** and that the matching products in both stores use exactly the **same SKU**.

***

## Before you start: product sync by SKU

This point is **essential** for the integration to work correctly.

Hurry matches products between both stores using the **SKU of each product or variant**.

This means product names, descriptions and images can differ between the two stores. What matters is that matching products have **exactly the same SKU**.

| Product in white store | Product in grey store | SKU | Result |
| :- | :- | :- | :- |
| Premium Sneaker | Nike Air Max Sneaker | `SHOE-001` | ✅ Matched correctly |
| Basic T-shirt | Nike Sportswear T-shirt | `TSHIRT-002` | ✅ Matched correctly |
| Premium Backpack | The North Face Backpack | `BACKPACK-003` | ✅ Matched correctly |
| Classic Watch | Casio Vintage Watch | `WATCH-004` | ✅ Matched correctly |
| Urban Sunglasses | Ray-Ban Aviator Sunglasses | `GLASSES-005` | ✅ Matched correctly |

For example, even if the product is called **Premium Sneaker** in one store and **Nike Air Max Sneaker** in the other, Hurry knows they are the same product because both use the SKU `SHOE-001`.

### Incorrect example

| Product in white store | SKU | Product in grey store | SKU | Result |
| :- | :- | :- | :- | :- |
| Premium Sneaker | `SHOE-001` | Nike Air Max Sneaker | `NIKE-001` | ❌ Not matched |

In this case, Hurry can't identify the matching product because the SKUs are different.

> **Important:** Check the SKUs of all products and variants before activating the integration. The match must be exact, including letters, numbers, hyphens and spaces.

***

## Step 1. Set up a domain in Shopify

Before connecting the store to Hurry, make sure it has a domain set up correctly in Shopify.

You can check this under:

**Settings → Domains**

![Image](https://mintcdn.com/hurrypay/k5OJMraVwMEnwCi1/images/image-36.png?fit=max\&auto=format\&n=k5OJMraVwMEnwCi1\&q=85\&s=3247d84bd44e50f88451614a4ed3a519)

***

## Step 2. Set up the checkout subdomain

Create a subdomain for the checkout following the same procedure used for the Stripe connection.

For example:

`checkout.yourdomain.com`

In your domain's DNS provider, create an **A** record with the following settings:

| Type | Name | Value |
| :- | :- | :- |
| A | checkout | `72.62.171.20` |

![Image 15](https://mintcdn.com/hurrypay/oQxFKrVDiCWmzKRW/images/image-15.png?fit=max\&auto=format\&n=oQxFKrVDiCWmzKRW\&q=85\&s=372564599b1ea0847b7814eea176726f)

Once the record is created and has propagated correctly, you can continue creating the Shopify app.

***

## Step 3. Open the Shopify Dev Dashboard

In Shopify, go to:

**Settings → Apps**

Then open **Develop apps in Shopify Dev Dashboard**.

![Image](https://mintcdn.com/hurrypay/k5OJMraVwMEnwCi1/images/image-40.png?fit=max\&auto=format\&n=k5OJMraVwMEnwCi1\&q=85\&s=342e78c709794420e88b61b3d9dc6644)

![Image](https://mintcdn.com/hurrypay/k5OJMraVwMEnwCi1/images/image-41.png?fit=max\&auto=format\&n=k5OJMraVwMEnwCi1\&q=85\&s=4499b84fff494dfdb8fb58c8a5206840)

![Image](https://mintcdn.com/hurrypay/k5OJMraVwMEnwCi1/images/image-42.png?fit=max\&auto=format\&n=k5OJMraVwMEnwCi1\&q=85\&s=439674cdbbee821aeed0ab4d34878e19)

![Image](https://mintcdn.com/hurrypay/k5OJMraVwMEnwCi1/images/image-43.png?fit=max\&auto=format\&n=k5OJMraVwMEnwCi1\&q=85\&s=7693eb9ee52553d0fd6638e00126ee35)

From here, create a new app for the Hurry integration.

***

## Step 4. Set the domain

While setting up the app, enter the checkout subdomain, always using HTTPS.

For example:

`https://checkout.yourdomain.com`

> **Important:** Always include `https://` when entering the domain.

![Image](https://mintcdn.com/hurrypay/k5OJMraVwMEnwCi1/images/image-44.png?fit=max\&auto=format\&n=k5OJMraVwMEnwCi1\&q=85\&s=e969b768f7d67fa317134db59ee5d50c)

***

## Step 5. Set the app permissions

While setting up the app, copy and paste the following scopes:

`read_customers,write_draft_orders,read_draft_orders,read_orders,read_products`

These permissions let Hurry read the customer, product and order information it needs, and create the Draft Orders required for the integration.

![Image](https://mintcdn.com/hurrypay/k5OJMraVwMEnwCi1/images/image-45.png?fit=max\&auto=format\&n=k5OJMraVwMEnwCi1\&q=85\&s=6617604efd35ede7ee019ae8dfba6707)

***

## Step 6. Get the credentials

Once the app is created, go to **Settings** in the Shopify Dev Dashboard.

Copy the following credentials:

* **Client ID**
* **Client Secret**

![Image](https://mintcdn.com/hurrypay/k5OJMraVwMEnwCi1/images/image-46.png?fit=max\&auto=format\&n=k5OJMraVwMEnwCi1\&q=85\&s=9d7d6d2737168f3fdf92750a79a7273a)

Go back to Hurry and paste each value into its field in the integration settings.

> **Security:** The Client Secret is a private credential. Don't share it or publish it in documentation, screenshots or public channels.

***

## Step 7. Connect the app

Once you've entered the credentials, save the settings and click **Connect app**.

Complete the Shopify authorization process and, when it's finished, check that the integration shows as **Active** in Hurry.

![Image](https://mintcdn.com/hurrypay/k5OJMraVwMEnwCi1/images/image-47.png?fit=max\&auto=format\&n=k5OJMraVwMEnwCi1\&q=85\&s=7ea7e3bbc545273129cd276392438d98)

![Screenshot 2026 07 03 At 09 04 44](https://mintcdn.com/hurrypay/k5OJMraVwMEnwCi1/images/Screenshot-2026-07-03-at-09.04.44.png?fit=max\&auto=format\&n=k5OJMraVwMEnwCi1\&q=85\&s=6a79c17e4d9d248b28ced6528399c837)

![Image](https://mintcdn.com/hurrypay/k5OJMraVwMEnwCi1/images/image-48.png?fit=max\&auto=format\&n=k5OJMraVwMEnwCi1\&q=85\&s=7796f472402706af8e31c986ae03e3a2)

![Image](https://mintcdn.com/hurrypay/k5OJMraVwMEnwCi1/images/image-49.png?fit=max\&auto=format\&n=k5OJMraVwMEnwCi1\&q=85\&s=634c9737e092f83c09d3c4cd6a62b1ae)

![08d6730f236f8b21558e2b519578d1dadcc8415a28170937c83d9e9a0746e4dc Image 2 (1)](https://mintcdn.com/hurrypay/k5OJMraVwMEnwCi1/images/08d6730f236f8b21558e2b519578d1dadcc8415a28170937c83d9e9a0746e4dc-image_2-\(1\).png?fit=max\&auto=format\&n=k5OJMraVwMEnwCi1\&q=85\&s=f18a1ec93624c15f16a9a22fec76fe46)

***

## Final check

Before you start processing orders, check the following:

* The store's domain is set up correctly.
* The checkout subdomain resolves correctly.
* The app has all the required scopes.
* The Client ID and Client Secret are correct.
* The app shows as active.
* Matching products in both stores have exactly the same SKU.

Once you've checked these points, the integration is ready to use.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.