Setting up RevenueCat integration

Learn how you can connect your RevenueCat dashboard to your FunnelFox account

To setup RevenueCat integration you need to perform 2 steps:

  1. Set your RevenueCat API keys in your FunnelFox settings
  2. Map your Stripe/Paddle products to entitlements in your RevenueCat Dashboard

API Keys

In order to setup integration FunnelFox needs to have access to several RevenueCat API keys:

  • Secret API Key Version 1
  • Stripe App Public Key (only for Stripe subscriptions)
  • Paddle App Public Key (only for Paddle subscriptions)

🤔

In Settings there is also iOS App Public Key

iOS App Public Key is a deprecated way to work with web subscriptions in RevenueCat. This setting helps to support existing subscriptions.

You can ignore this setting if you are just starting out.

RevenueCat API keys settings

RevenueCat API keys settings

Below you can find instructions how to find every key.

Finding RevenueCat Secret API key

  1. In your RevenueCat Dashboard go to Project Settings → API keys
  2. Create a new secret key with API version set to V1
  3. Copy this key into Secret Key input in your FunnelFox Dashboard Integrations → RevenueCat
Creating new Secret API Key

Creating new Secret API Key

Finding RevenueCat Stripe App Key

You are going to need a Stripe app in your RevenueCat Dashboard. Check out RevenueCat documentation, if you don't have one.


  1. Make sure that Track new purchases from server-to-server notifications is disabled in
  2. In your RevenueCat Dashboard go to Project Settings → API keys
  3. Copy Key from your Stripe App (should begin with strp_)
  4. Copy this key into Public Stripe App Key input in your FunnelFox Dashboard Integrations → RevenueCat
_Track new purchases from server-to-server notifications_ should be disabled

Track new purchases from server-to-server notifications should be disabled

Finding RevenueCat Paddle App Keys

You are going to need 2 Paddle apps in your RevenueCat Dashboard. Check out RevenueCat documentation, if you don't have them.

🤔

Why two apps?

There are two separate environments in Paddle: Sandbox and Production.

You will need to have a separate Paddle app in RevenueCat for each:

  • RevenueCat Paddle App (Production)
  • RevenueCat Paddle App (Sandbox)

Make sure that checkbox "Is Sandbox environment" is checked in your RevenueCat Paddle Sandbox App settings.

  1. In your RevenueCat Dashboard go to Project Settings → API keys
  2. Copy Key from your Paddle Production App and Paddle Sandbox App (should begin with pdl_)
  3. Copy these keys into Production Paddle App Key and Sandbox Paddle App Key inputs in your FunnelFox Dashboard Integrations → RevenueCat

Mapping Stripe/Paddle products to entitlements

While FunnelFox creates profiles with subscriptions, these profiles are not automatically granted with entitlements. You are going to need to set up entitlement mapping based on purchased product in your RevenueCat Dashboard.

Check out RevenueCat documentation to learn how to map Stripe/Paddle products to entitlements.

Example `pro` entitlement mapped to a Stripe product

Example pro entitlement mapped to a Stripe product


And... that's it! 🎉 You are good to go!