Connect Shopify

No module to install: Shopify pushes orders through signed webhooks, and a storefront pixel covers browsing.

1. Create the order webhook

Shopify admin: Settings > Notifications > Webhooks.
Create an Order payment webhook, JSON format, pointing to:
https://serverside.datafirefly.com/v1/shopify/YOUR-SITE-ID
replacing YOUR-SITE-ID with the exact Site ID from your site page.
Recommended: also add Refund creation so refunds flow through. Checkout creation and Cart creation are only useful until the storefront pixel is in place.

Pick Order payment, never Order creation: the latter also fires for unpaid orders and causes double counting.

2. Paste the signing secret

At the bottom of the Webhooks page, Shopify shows the signing secret: copy it.
Paste it into the "Shopify webhook signing secret" field on your DataFirefly site page, then save.

3. Add the storefront pixel

Shopify admin: Settings > Customer events > Add custom pixel.
Paste the snippet provided in the Shopify guide of your client area (Modules page).
Once the pixel is live, delete the Checkout creation and Cart creation webhooks: the pixel replaces them.

Verify

Place a paid test order: it must show as Delivered in Monitoring.
The "Diagnose my connection" button confirms the latest events received.

If something goes wrong

A webhook that keeps failing for about 48 hours is deleted automatically by Shopify. If the webhook is gone, check the Site ID in the URL, recreate it and watch Monitoring.
Duplicate orders? Check that no Order creation webhook is left over.
The other frequent causes are listed in the troubleshooting guide.

Updated: September 1, 2026