Webhooks
What Luria receives from Shopify and from its billing processor, why there is nothing for you to configure, and what to do instead of outbound webhooks.
Luria receives webhooks. It does not send them.
There is no outbound event feed for merchants: no "a test won" webhook, no per-conversion webhook, nothing to point at Zapier, Make, or your own endpoint. If you need Luria's data somewhere else, use the export described at the bottom of this page.
Everything below is registered for you when you install the Shopify app. There is no URL to paste and no secret to copy.
What you'll need
- The Luria app installed on your Shopify store (Install on Shopify)
- The Data Processing Terms approved inside the app, which is what turns the engine on
- Nothing else, on non-Shopify sites there are no webhooks at all
Steps
Step 1: Install the app, which registers the topics
Installing subscribes your store to the topics Luria uses and points them at Luria's receiver. Every delivery is signature checked before it is read, and a verified delivery always gets an immediate acknowledgement, so a slow or failed process on Luria's side never makes Shopify retry against your store.
Step 2: Know what each one does
| What arrives | What Luria does with it |
|---|---|
| Order webhooks | Counts one conversion per order, matched to the variant the session saw. The Luria web pixel reports the same purchase at checkout; both use the same key (shopify:order:<id>), so one order counts once. |
| Refund webhooks | When cumulative refunds reach the full order total, the order stops counting and gives your free-allowance slot back. Tracked revenue drops by the refunded amount. |
| App uninstalled | Marks the connection removed, deletes the stored access tokens, pauses the site so serving stops within about 60 seconds, and cancels any Luria subscription. |
| Customer data request | Recorded and raised as an open request with a 30 day clock. You are the controller, so Luria replies to you within 30 days. |
| Customer redact | Deletes Luria's stored copies of that customer's Shopify records. |
| Shop redact | Deletes your events, changes, site, connection, sync jobs and consent records. The usage counter stays, because it is the billing record and holds no personal data. |
| Product and inventory updates | Keeps Luria's copy of your catalog current for page and product metrics. |
Billing webhooks arrive separately, from the processor that handles your Luria subscription on luriart.com. A paid invoice puts the plan into active, a failed payment moves it to past due, and a cancelled subscription ends it. Past due and cancelled both stop variants from serving until payment clears.
Step 3: If you need the data elsewhere, export it
In the Luria app inside your Shopify admin, open the "Your data" card and choose Export everything (JSON). The file contains your connection details, site record, consent record, usage counters, sync status, install history, raw events and the synced copies of your Shopify objects. Access tokens are never included.
Not on Shopify, or you need something the export does not cover? Email hello@luriart.com.
Verify it worked
- Open the Luria app in your Shopify admin. In the Status card, "App connection" reads Connected and "Data agreement" reads Accepted.
- The Conversion tracking card says the built-in pixel is reporting. If it has not reported yet, paste the backup pixel it offers you.
- Place a test order. Within a few minutes, "Conversions this period" on the dashboard Overview goes up by one.
Common failures
- Conversions stop after a theme change. Publishing a new theme drops the app embed. Switch Luria back on in the new theme under App embeds, then Save.
- Everything went quiet after uninstalling. That is the uninstall webhook doing its job. Reinstall to start again.
- Refunds are not reducing your count. Only a full refund returns a free-allowance slot. Partial refunds reduce tracked revenue but keep the conversion.
- Luria's numbers differ from Shopify's. Luria counts attributed orders net of full refunds. Shopify counts every order. See Numbers don't match Shopify.
- Waiting on an outbound webhook. There is not one. Use the JSON export, or email hello@luriart.com.
Next steps
Count PayPal payments
Return PayPal buyers to a thank-you page on your own site and count the purchase there, because there is no PayPal connection to set up.
Luria's API surface
The two JavaScript calls Luria exposes, why there are no API keys or public REST endpoints today, and how to get your data out instead.