Shopify checkout

Shopify Checkout Extensibility tracking

If your Shopify plan/theme no longer supports “Additional scripts”, use webhooks + a server to report conversions reliably.

Back to Shopify guide

What changes with Checkout Extensibility

Many stores can’t run custom JavaScript on the order status page anymore. The reliable path is:

Shopify triggers an order webhook (paid/fulfilled).
Your server receives the webhook and extracts the discount/coupon code and order details.
Your server calls Refer Labs to credit the ambassador.

Server → Refer Labs call

Your server calls the discount capture endpoint using your Discount Capture Secret (from the dashboard).

Never expose the secret in public storefront code. Keep it server-side.

Request format

POST https://referlabs.com.au/api/discount-codes/redeem
Headers:
  Content-Type: application/json
  x-pepf-discount-secret: <ADD_SECRET>
Body:
{
  "discountCode": "CODE_FROM_ORDER",
  "orderReference": "ORDER-12345",
  "amount": "199.00",
  "metadata": {
    "platform": "shopify",
    "shopify_order_id": "1234567890",
    "email": "customer@example.com"
  }
}

Testing checkpoints (do these in order)

Create a test ambassador in the dashboard and note their discount code.
Confirm the Shopify order actually contains the discount code you expect (coupon codes are ideal).
Trigger a test order (use a low-value test product) and confirm your webhook receiver gets the event.
From your server logs, confirm your call to /api/discount-codes/redeem returns success.
Confirm the redemption/conversion shows in the Refer Labs dashboard for the correct ambassador.
If anything doesn’t appear, run the Status page checks.

Common troubleshooting

Missing discount code: ensure the code is a real Shopify discount/coupon applied to the order.
Multiple codes: pick the first coupon code consistently, or enforce one code at checkout.
Webhook retries: make your server handler idempotent (use orderReference as a unique key).
Wrong timing: use “order paid”/“fulfilled” (not “created”) to avoid false positives.