Connect Shopify
Install the Hygge app on your Shopify store via OAuth — what we ask for, why, and what to do if it fails.
Hygge installs on Shopify like any app — through standard OAuth. We never ask for an admin password or store data we don't need.
What permissions we request#
We only request the scopes required to run a checkout. Specifically:
| Scope | Why |
|---|---|
read_products, write_orders | Verify variant prices and create the paid order back in Shopify |
read_orders, read_customers | Look up the order to attach the right customer |
write_checkouts, read_checkouts | Render and close the buyer's checkout |
We do not request write_products, write_customers, theme write access, or any payment processor scopes.
Walkthrough#
- Start from the dashboard
Log into your Hygge dashboard, click Connect Shopify on the setup widget. We'll ask for your store handle (e.g.
yourstoreoryourstore.myshopify.com— both work). - Approve in Shopify
Shopify shows a permissions screen listing the scopes above. Click Install app.
- Land back in the dashboard
Shopify redirects you back to Hygge with a confirmation. We immediately register the webhooks we need — including the GDPR-mandated ones — and inject a lightweight script tag into your storefront.
What we install on your store#
- One script tag loaded with
display_scope=online_store. It listens for cart updates and opens the Hygge drawer when the buyer clicks Checkout. - Five webhooks:
orders/create,app/uninstalled, plus the three GDPR webhooks Shopify requires (data request, customer redact, shop redact).
No theme files are modified. Uninstalling Hygge removes the script tag automatically.
What if OAuth fails?#
Most OAuth failures fall into one of these buckets:
- "Invalid shop domain" — make sure you're typing the part before
.myshopify.com, not your custom domain. We accept either form, but custom domains (e.g.yourstore.com) won't validate. - "State mismatch" — your browser blocked the OAuth cookie. Disable strict tracking protection for
payhygge.comand retry. - Redirect loop — clear cookies for
*.myshopify.comandpayhygge.com, then start the install over.
If none of those help, email hello@payhygge.com with the URL you landed on — there's almost always a query param in there that tells us exactly what failed.