> For the complete documentation index, see [llms.txt](https://docs.foodcore.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.foodcore.io/shop-integration-core/shopify.md).

# Shopify

{% hint style="info" %}
📦 Available on the **Core** plan.
{% endhint %}

Shopify orders can flow into FoodCore automatically, and — if you want it — FoodCore can tell Shopify when an order is ready. Read [Integrations](https://docs.foodcore.io/shop-integration-core/integrations.md) first if you haven't already, particularly the ordering constraint: the shop record has to exist in FoodCore before Shopify has anywhere to send its webhook.

## Orders in

**1. Add the shop in FoodCore**

Go to **Integrations** and add the shop. Enter the `yourshop.myshopify.com` address — use that address even if the store also has its own custom domain, since that's the one Shopify's webhooks are tied to. **Leave the signing secret blank** for now. Press **Connect shop**.

**2. Copy the webhook address**

FoodCore shows a webhook URL on the shop's card once it's created. **Copy it** — you'll paste it into Shopify next.

**3. Find Shopify's webhook settings**

In your Shopify admin, go to **Settings → Notifications → Webhooks**. Settings is the cog icon at the very bottom-left of the Shopify admin sidebar. On the Notifications page, **scroll to the bottom** — Webhooks is the last section on that page.

**4. Create the webhook**

Click **Create webhook** and fill it in:

* **Event**: Order creation
* **Format**: JSON
* **URL**: the webhook address you copied in step 2
* **API version**: leave whichever version Shopify suggests

**Save**.

**5. Copy the signing secret**

Under the webhook list, Shopify shows a line like *"Your webhooks will be signed with…"* followed by a long string. **Reveal it, copy the whole thing**, and paste it into the shop's card back in FoodCore.

**6. Repeat step 4 for "Order updated"**

Create a second webhook with the same URL and JSON format, but event **Order updated**. This keeps a changed order (address correction, item swap) in step with FoodCore. The signing secret is shared across a shop's webhooks — you don't need to paste it again.

Shopify **chooses** the signing secret and only shows it once per shop, not once per webhook. If it's ever regenerated on Shopify's side, the new value has to be pasted into FoodCore or orders will stop arriving — with no error visible in Shopify, since from its side every delivery still looks like it went out fine.

## Fulfilment out (optional)

Sending fulfilment back to Shopify means FoodCore acts *as* the shop, so it needs a real API key. This is **off by default, per shop**. Shopify has retired the old custom-app flow that handed out a token to paste directly, so this is now an OAuth approval instead.

**1. Open app development**

In the store admin, go to **Settings → Apps → App development**, then choose **"Build apps in Dev Dashboard"**.

**2. Create the app**

Name it something recognisable, such as **FoodCore**. Nothing about this app is published or listed publicly — it exists only to authorise this connection.

**3. Set the redirect URL**

Set the app's **Redirect URL** to the address FoodCore shows on the fulfilment panel.

**4. Set the scopes**

Add the scopes listed on the FoodCore panel.

**5. Release a version**

Dev Dashboard apps are **versioned** — redirect URL and scope changes do nothing until a version is released. **Release a version** after making the changes above.

**6. Copy the credentials and connect**

In the app's **Settings → Credentials**, copy the **Client ID** and **Secret** (the secret is behind the eye icon). Paste both into FoodCore, save, then press **Connect to Shopify**. Shopify will ask you to approve the app on your own shop and hands the token over behind the scenes — you never see or paste the token itself.

### Troubleshooting

**"redirect\_uri is not whitelisted"** — either the URL in step 3 doesn't match what FoodCore shows exactly, or the version carrying that change was never released. Check both.

**Approval succeeded but it still looks unfinished** — the scopes were changed after the last release. Release the app again, then press **Connect** once more.

**Wrong credential pasted** — three values look plausible and only one is correct:

| Value                                             | What it actually is                                           |
| ------------------------------------------------- | ------------------------------------------------------------- |
| Starts `shpss_`                                   | The API **secret key** — signs webhooks, not what OAuth needs |
| Bare 32-character hex string                      | The public **API key** — an identifier, not a secret          |
| Client ID + Secret from Dev Dashboard credentials | ✅ What Connect to Shopify needs                               |

## When fulfilment is sent

Set **"push on status"** to **Ready** or **Delivered** on the shop's card:

* **Ready** suits collection orders — the push is effectively an invitation to come and collect.
* **Ready also fires on Delivered**, so an order that skips the Ready status on its way to Delivered still tells the shop.

If two people mark the same order Ready, only one fulfilment is sent. If the push fails (for example, a token has expired), it's retried automatically once the credentials are fixed. If Shopify already agrees the order is fulfilled, FoodCore leaves it alone rather than sending a duplicate.

## What's next

* [Integrations overview](https://docs.foodcore.io/shop-integration-core/integrations.md)
* [WooCommerce setup](https://docs.foodcore.io/shop-integration-core/woocommerce.md)
* [Order statuses](https://docs.foodcore.io/customer-orders-growth-and-core/statuses.md)
* [Business Insights overview](https://docs.foodcore.io/business-insights-core/business-insights.md)
