RevenueCat

If your app runs RevenueCat, Invitebase can qualify referrals on real subscription revenue without you tracking a single purchase event. Purchases are one of the best Qualification Gates, and Invitebase's RevenueCat integration makes it easy to automatically receive these events. See our guide on Reward on Paid Subscriptions for why purchases are one of the simplest and best ways to verify referrals.

Connect RevenueCat

Environments

RevenueCat tags each event with its environment; Invitebase routes them automatically:

One connection covers both. Sandbox purchases can therefore drive your whole test-mode referral loop and never touch live data or billing.

Identity: the one convention

Invitebase resolves RevenueCat events to users by matching RevenueCat's app_user_id against the user ID you pass to identify():

Invitebase.identify(user.id)          // must be the same value…
Purchases.logIn(user.id)              // …as your RevenueCat app user ID

If you already use your own user IDs as RevenueCat app user IDs (the common setup), there is nothing to do. Events for users Invitebase has not seen yet are parked and retried once the user is identified — a purchase arriving moments before the signup event is not lost.

Anonymous RevenueCat IDs ($RCAnonymousID:…) cannot be matched — make sure logIn runs for referred users before purchase, or attribution to the referral will not resolve.

Event mapping

RevenueCat webhook events map to canonical Invitebase events:

Mapped events carry useful properties you can restrict gate conditions by: product_id, store (app_store, play_store, stripe), price, currency, period_type, and plan (paid for non-trial starts). Every mapped event is visible in Developer tools → Events with the raw RevenueCat payload attached, and source: revenuecat on the API.

Use it in a gate

The flagship gate — validate when the referred user starts a paid subscription. In the gate builder, add one required condition on subscription_started, restricted to plan: paid, with a 14-day window.

Gate on trial_converted for trial-based funnels, or restrict the condition to product_id: pro_annual to reward only annual conversions. Refund events are wired into fraud controls: a refund inside the hold window can claw back the reward before payout. Full walkthrough: Reward on paid subscription.

Test with the RevenueCat sandbox

1. Set up a linked test referral (see the test-mode walkthrough).
2. In your development build, sign in as the referred test user and make a sandbox purchase (StoreKit test / Play billing test track).
3. RevenueCat fires the webhook with environment: SANDBOX; Invitebase maps it into test mode and the gate evaluates within seconds.
4. Watch the referral flip to validated in the dashboard.

No sandbox purchase handy? Developer tools → Events → Simulate can fire a synthetic RevenueCat INITIAL_PURCHASE against any test-mode user.

What's next