RevenueCat analytics: revenue by channel

Setup steps

1. In RevenueCat, create a version 2 secret API key with customer information read access.
2. In ProductLense, open Settings → Billing connections → RevenueCat, paste the key, the project id and a random authorization value.
3. In RevenueCat → Integrations → Webhooks, add a webhook endpoint with the URL ProductLense shows after you save the connection (pattern https://api.productlense.app/api/webhooks/{provider}/{connection_id}).
4. Paste the same authorization value into RevenueCat and choose Production events.
5. In your app, call Purchases.setAttributes(await ProductLense.revenueCatAttributes()) once.

Credentials and permissions

Webhook

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

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

Events: INITIAL_PURCHASE, RENEWAL, NON_RENEWING_PURCHASE, CANCELLATION, REFUND_REVERSED, EXPIRATION, BILLING_ISSUE, PRODUCT_CHANGE

Verification: Authorization header value you set in RevenueCat, compared in constant time.

What ProductLense reads

Customers

Customers with their subscriber attributes, including pl_install_id and $email.

Subscriptions

Subscriptions with status, product and billing period.

Payments

Purchases and App Store and Google Play renewal transactions.

Refunds

Refunded purchases and CUSTOMER_SUPPORT cancellations.

Fees

Store commission plus tax as RevenueCat estimates them, marked estimated.

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

The pl_install_id attribute links each purchase to the app install, so it is attributed even before the user signs in.

import Purchases from 'react-native-purchases';
import ProductLense from '@productlense/react-native';

// links purchases to the install's first touch, even before sign-in
Purchases.setAttributes(await ProductLense.revenueCatAttributes());
// after sign-in, your user id joins app and web purchases
await Purchases.logIn(user.id);
ProductLense.identify(user.id);