See what your app earns next to how people use it: monthly recurring revenue (MRR), lifetime value (LTV) by cohort, and your paywall funnel. Vexo records revenue from your own RevenueCat project or Stripe account through a signed webhook. Vexo never asks for access to either account and never calls them.
Revenue analytics is on paid plans: the app's owner needs a card on file. Without one, the Revenue page and its settings show Available on paid plans.
identifyDevice. Vexo never matches people by email. In RevenueCat, use that ID as the App User ID. In Stripe, put it in the subscription's vexo_user_id metadata. A payment without an ID still counts in your totals, but not in per-person figures such as LTV.Vexo records these events:
| Vexo event | From RevenueCat | From Stripe |
|---|---|---|
| Trial started | INITIAL_PURCHASE in a trial period | Not recorded |
| Purchase | INITIAL_PURCHASE, NON_RENEWING_PURCHASE | invoice.paid for a new subscription or a one-off invoice |
| Renewal | RENEWAL | invoice.paid for a renewal or a plan change |
| Trial converted | RENEWAL that converts a trial | Recorded as a renewal |
| Refund | CANCELLATION with a refund, REFUND_REVERSED | refund.created |
Other events, such as cancellations, expirations, and billing issues, don't move money, so Vexo doesn't record them.
https://api.vexo.co/inbound/revenuecat/YOUR_APP_ID.import Purchases from 'react-native-purchases';
import { identifyDevice } from 'vexo-analytics';
await identifyDevice(user.id);
await Purchases.logIn(user.id);
Log in to RevenueCat before the purchase. A purchase that RevenueCat reports with only an anonymous ID ($RCAnonymousID:...) counts in your totals, but not for any person.
https://api.vexo.co/inbound/stripe/YOUR_APP_ID.invoice.paid and refund.created events. See Stripe's guide to webhook endpoints. Any API version works.whsec_.vexo_user_id. With Stripe Checkout, set it in subscription_data.metadata:const session = await stripe.checkout.sessions.create({
mode: 'subscription',
line_items: [{ price: 'price_123', quantity: 1 }],
subscription_data: { metadata: { vexo_user_id: user.id } },
success_url: 'https://example.com/success',
});
Vexo also reads vexo_user_id from the invoice's metadata, an invoice line's metadata, and a refund's metadata. Vexo doesn't read customer metadata: webhooks don't include the customer, and Vexo never calls Stripe.
The Revenue page uses the date range at the top of the page.
import { customEvent } from 'vexo-analytics';
customEvent('paywall_viewed', { offering: 'default' });
Without a paywall event, the funnel starts at the first trial or purchase.
| Problem | What to check |
|---|---|
| The Revenue page stays empty | You're testing in RevenueCat's sandbox or Stripe's test mode, which Vexo doesn't record. |
| RevenueCat or Stripe shows failed deliveries with status 401 | The signing secret in Vexo doesn't match the vendor's, or RevenueCat's webhook signing is off. Save the current secret again. |
| Revenue shows, but Paying customers and LTV are low | Payments arrive without a user ID. Check RevenueCat's App User ID or Stripe's vexo_user_id metadata. |
| LTV leaves out some payers | Vexo hasn't seen those people in the app: they paid on the web without using the app. |