Shopify analytics: revenue by channel

Setup steps

1. In Shopify admin, open Settings → Apps and sales channels → Develop apps and create a custom app.
2. Give it the read_orders and read_customers Admin API scopes, install it, and copy the access token.
3. In ProductLense, open Settings → Billing connections → Shopify and paste the shop domain, token and client secret.
4. In the custom app, add a webhook endpoint with the URL ProductLense shows after you save the connection (pattern https://api.productlense.app/api/webhooks/{provider}/{connection_id}).
5. ProductLense backfills 12 months of paid orders.

Credentials and permissions

Webhook

URL pattern, shown with your connection id after you save:

https://api.productlense.app/api/webhooks/shopify/{connection_id}

Events: orders/paid, orders/updated, refunds/create, customers/create, customers/update

Verification: X-Shopify-Hmac-Sha256 header: base64 HMAC of the body, plus a shop domain check.

What ProductLense reads

Customers

Customers with email.

Subscriptions

None: Shopify orders are one-off purchases.

Payments

Paid orders.

Refunds

Order refunds.

Fees

Not in the orders API (fees live in the Payouts API), so recorded as 0.

What ProductLense never touches

• Never creates, changes, refunds or cancels anything: read-only API calls and incoming webhooks only.
• Never moves money, issues payouts, or reads bank account details.
• Never sees full card numbers; providers do not expose them.
• Never sends your customer data to the AI model: Ask and the daily insight see aggregates only.

Match payments to your users

Add the ProductLense script to theme.liquid and set a pl_user_id cart attribute for logged-in customers to match by id; otherwise ProductLense matches by customer email. See the Shopify install guide.

fetch('/cart/update.js', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({ attributes: { pl_user_id: String(customerId) } }),
});