For brands
Connect Shopify
Set your program's destination to your store, create two webhooks in Shopify admin (Order payment and Refund create) to your program's address, and paste Shopify's webhook secret into the console. Nothing to install in your theme.
Set up
- Set the program's destination to your store. Partner links land there with
?ref=andvp_click=, and Shopify keeps the landing address with each order (landing_site). - In Shopify admin, open Settings, Notifications, Webhooks, and create two webhooks in JSON format to
POST /api/shopify/webhook/<program id>(copy it from the Integration tab): Order payment (orders/paid) and Refund create (refunds/create). - Shopify shows the secret that signs your webhooks under the list of webhooks. Paste it into the program's Integration tab.
How orders are read
| Shopify topic | Becomes | Attribution |
|---|---|---|
orders/paid | One sale per order | The click id from landing_site or a vp_click cart attribute, else a partner coupon in discount_codes, else ref. |
refunds/create | A refund | The refunded amount is added to what is already refunded, and the commission falls in proportion. |
Commission is worked out on the order subtotal after discounts, without shipping and tax. Each request is checked against the X-Shopify-Hmac-Sha256 header; unsigned requests are refused.
On the live network, going live needs one signed event from the event API or a Stripe webhook. A Shopify order does not count for that check today. Send one test event through the event API, or ask us to review your program.
Something here does not match what you see in the product? Email max@viralpayouts.com.