Shopify
Shopify sends each order to a EdenClick webhook, where it becomes a contact and a deal. Signatures are verified with your webhook secret, and commission is resolved when the conversion was attributed through the tracking snippet.
Setup
- In EdenClick, open Settings → Shopify and copy theWebhook URL.
- Generate a secret (or paste your custom app's API secret) and save it — this is used to verify Shopify's signatures.
- 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
| Customer | Upserted as a contact by email; company from the billing address |
| Deal title | Order name (e.g. #1001) — idempotent upserts |
| Value | total_price, set when the order is paid |
| Commission | Resolved from the attributed link or partner rate when the visitor came through a /ref link |
Status mapping
| paid | Deal stage Won, value = order total |
| partially_refunded | Deal stage Won (kept for the record) |
| refunded / voided | Deal stage Lost, value 0 |
| pending / other | Deal stage Lead In, value 0 |
A later Order updated webhook moves the same deal to the new stage instead of creating a duplicate.