Redirecting you…

Skip to main content

← All docs

ShopifyComing soon

The Shopify integration is being reworked and is not available yet. While it's offline, use the WordPress plugin or tracking snippet to capture orders. The notes below document the planned behavior.

Setup

  1. In EdenClick, open Settings → Shopify and copy theWebhook URL.
  2. Generate a secret (or paste your custom app's API secret) and save it — this is used to verify Shopify's signatures.
  3. In Shopify, go to Settings → Notifications → Webhooks(or your custom app's webhook subscriptions), clickAdd webhook, select Order createdand Order updated, and paste the URL. Set the signing secret to the value you saved.

Webhook endpoint

POST /api/v1/shopify?id=<tracking-id>

The id query parameter routes the payload to the correct workspace. TheX-Shopify-Hmac-Sha256header is verified against the saved secret.

Order mapping

CustomerUpserted as a contact by email; company from the billing address
Deal titleOrder name (e.g. #1001) — idempotent upserts
Valuetotal_price, set when the order is paid
CommissionResolved from the attributed link or affiliate rate when the visitor came through a /ref link

Status mapping

paidDeal stage Won, value = order total
partially_refundedDeal stage Won (kept for the record)
refunded / voidedDeal stage Lost, value 0
pending / otherDeal stage Lead In, value 0

A later Order updated webhook moves the same deal to the new stage instead of creating a duplicate.

REST API reference