Overview
Revenue integrations let you attach the money side of your business to your analytics. Once a provider is connected, OpenRevenue shows revenue, orders, and conversion rate across your dashboard, including per country, page, referrer, and visitor. You connect a provider per project underSettings, in the Revenue API section. This is separate from the tracker’s transaction() call, which only records that a conversion happened without an amount.
Supported providers
Pick one provider per project. Most connect with an API key. Shopify connects with app credentials, and RevenueCat connects with a webhook.Polar
API key Paste an Organization Access Token (polar_oat_…). Adds Average Order Value and MRR.
Stripe
API key Paste a restricted, read-only secret key.
Lemon Squeezy
API key Paste an API key from your store settings.
Paddle
API key Paste an API key from your Paddle dashboard.
Dodo Payments
API key Paste an API key from your Dodo dashboard.
Shopify
App credentials Enter your store domain plus the Client ID and Client secret of an app with read access to orders.
RevenueCat
Webhook Connect a webhook instead of a key. Best for mobile app revenue.
Connect with an API key
For Polar, Stripe, Lemon Squeezy, Paddle, and Dodo:- Open
Settingsfor your project and find theRevenue APIsection. - Choose your provider from the
Pick your payment providermenu. - Paste your provider API key into the field and click
Connect.
Connect Shopify
Shopify needs your store domain and the credentials of an app installed on that store. OpenRevenue reads orders and refunds through the Admin API and never writes to your store.- In the Shopify Dev Dashboard, create an app in the same organization as your store.
- Create a version of the app with the
read_ordersaccess scope. Addread_all_orderstoo if you want orders older than 60 days. If Shopify asks about protected customer data, allow access to orders. Name, email, phone, and street address are not needed. - Install the app on your store.
- Open the app’s
Settingsand copy theClient IDandClient secret. - In OpenRevenue, open
Settingsfor your project, find theRevenue APIsection, and choose Shopify. - Enter your store domain (for example
your-store.myshopify.com, not a custom domain), the Client ID, and the Client secret, then clickConnect.
Already have a custom app that was created in the Shopify admin before 2026? Leave the Client ID empty and paste that app’s Admin API access token (
shpat_…) into the Client secret field instead. Shopify no longer lets you create this kind of app, so new setups use the steps above.- Revenue is the amount received on each order, in your store currency, dated by when the order was created. Unpaid, voided, and test orders are left out.
- Refunds are counted on the day they were issued.
- Country comes from the order’s billing address, so point of sale orders without one are not shown per country.
Connect RevenueCat
RevenueCat sends purchases to OpenRevenue over a webhook:- In the
Revenue APIsection, choose RevenueCat and clickGenerate webhook. - Copy the
Webhook URLand theAuthorization headervalue shown. - In the RevenueCat dashboard, go to Project Settings, Integrations, Webhooks, and add a new webhook.
- Paste the URL and set the Authorization header to the value you copied.
Webhook URL
openrevenue_visitor_id subscriber attribute in your app to the visitor ID OpenRevenue assigns. Without it, revenue is still recorded and grouped by country and time.
OpenRevenue ingests purchase events (initial purchases, renewals, and one-time purchases). Cancellations, expirations, and billing issues are ignored.
Display currency
Choose a display currency in the same Settings section. Amounts are shown in that currency across your reports. The default is USD.Attribute revenue to a visitor
Once a provider is connected, all revenue, orders, and country totals show automatically — you don’t have to do anything. The step below is only needed to also break revenue down by the traffic source, page, and visitor that drove each sale. Attribution works by attaching the OpenRevenue visitor id to the order asopenrevenue_visitor_id. The tracker exposes it on the page as window.openrevenue.visitorId.
By default the tracker stores nothing in the browser, so the visitor id is the visitor’s ID for the current day. It is set a moment after the page loads, when the first pageview is answered; the tracker then fires an openrevenue:visitor event on window. A sale is attributed when the checkout starts on the same day as the visit. To attribute sales to visits on earlier days, store a visitor ID with consent.
Automatic — Polar & Lemon Squeezy
Their checkout is a hosted link, so the tracker tags it for you. No code needed — just link to your Polar or Lemon Squeezy checkout normally.One line — Stripe, Paddle & Dodo
These create checkout on your server, so pass the visitor id as metadata when you start checkout. Stripe Checkout (one-time payments):server.ts
checkout.ts
server.ts
One snippet — Shopify
Shopify copies cart attributes onto the order, so save the visitor id on the cart. Add this to your theme (for example at the end oftheme.liquid, after the OpenRevenue tracker):
theme.liquid
__openrevenue_visitor_id (two leading underscores) as the attribute name instead. Shopify hides attributes named that way from the storefront and checkout, and OpenRevenue reads both. Orders that skip the cart, such as point of sale and draft orders, are not attributed.
RevenueCat uses a subscriber attribute instead — see Connect RevenueCat.
Without the visitor id, a sale still counts toward your revenue, order, and country totals — it just won’t be attributed to a specific source or page.
What you see
After connecting, revenue appears throughout the dashboard:- Totals for revenue, orders, and conversion rate above the chart, plus AOV and MRR when Polar is connected.
- A revenue overlay on the main chart, and a Revenue metric you can switch the report tables to.
- Revenue, orders, and revenue per visitor broken down by country, page, referrer, device, browser, and OS.
- A revenue column on the Visitors list.