RevenueUI documentation
Revenue tracking
Connect Stripe revenue, import payment history, and associate verified visitor journeys with payment outcomes.
Connect Stripe
In website setup or revenue settings, create the linked Stripe restricted key. The connection asks for only the capabilities RevenueUI currently uses:
| Permission | Purpose |
|---|---|
| Charges and refunds: Read | Reconcile successful payments and refunds. |
| Subscriptions: Read | Calculate subscription and recurring-revenue state. |
| Webhook endpoints: Write | Create and remove RevenueUI's signed endpoint. |
RevenueUI verifies the restricted key before saving it. After connection, a historical import starts and its state is shown in the interface.
Attach visitor metadata
To connect a payment with a visitor journey, read the RevenueUI first-party identifiers in your backend when creating the relevant Stripe Checkout Session, PaymentIntent, or Subscription. Copy them to Stripe metadata:
cookie.revenueui_visitor_id -> metadata.revenueui_visitor_id
cookie.revenueui_session_id -> metadata.revenueui_session_id
RevenueUI validates identifiers against the website before attribution. Never invent an identifier or copy one between websites.
Understand data coverage
A payment can be imported without browser attribution. In that case it contributes to provider-backed revenue but is not assigned to a visitor journey, source, or landing page.
Trial value is an expected value based on available subscription data. It is not collected revenue. Refunds reduce the net payment value shown by RevenueUI.
Webhook recovery
Do not manually recreate a deleted Stripe endpoint by copying its old URL. The new endpoint has a different signing secret.
Instead, disconnect Stripe while choosing to keep imported revenue, then reconnect with the restricted key. RevenueUI registers a new signed endpoint and starts reconciliation again.
Disconnecting
The disconnect flow lets you either keep already imported revenue or permanently delete it with the connection. Read the confirmation carefully; deleting imported revenue changes the analytics history for that website.