Sign in
what's the app

Stripe Setup

Last updated: January 24, 2026

Follow these steps to connect your app with Stripe. This guide will walk you through creating a read-only API key and linking your app.

💡 Quick setup! Stripe integration only takes a few minutes - you just need to create a read-only API key and provide your app store URL.

🔒

Read-only access

We use a restricted API key with read-only permissions to retrieve your revenue and subscription metrics. We will never modify, update, or delete anything in your Stripe account.

Before You Start

Make sure you have:

  • •Access to your Stripe Dashboard account
  • •Admin or Owner role in Stripe (to create API keys)
  • •Your app's App Store URL and/or Google Play Store URL
1

Create a Restricted API Key

We only need read-only access to your Stripe data. Creating a restricted API key ensures we can only view your metrics, not modify anything.

📍 Stripe Dashboard → Developers → API Keys

  1. 1.Click here to create a read-only API key with pre-configured permissions (opens Stripe Dashboard)
  2. 2.The key name will be pre-filled as "WhatstheAPP" - you can change this if you prefer
  3. 3.Don't change the permissions - they're already set to read-only for the data we need
  4. 4.Scroll down and click "Create key"
💡

Pre-configured permissions

The link above pre-configures the following read-only permissions:

  • • Charges: Read (to calculate revenue)
  • • Subscriptions: Read (to calculate MRR)
  • • Connect Buckets: Read (for connected accounts)
  • • Files: Read (for receipts if needed)
2

Copy Your API Key

After creating the key, Stripe will display it once. Make sure to copy it immediately as you won't be able to see it again.

  1. 1.After clicking "Create key", your new API key will be displayed
  2. 2.The key will start with rk_live_ (for live mode) or rk_test_ (for test mode)
  3. 3.Click the "Copy" button or manually select and copy the entire key
  4. 4.Store it securely - you'll need it in Step 3
⚠️

Keep it secure!

Although this is a read-only key, you should still keep it secure. Don't share it publicly or commit it to version control. Don't delete the key or we won't be able to refresh your revenue data.

3

Enter Your Credentials

Now you'll enter your API key and app store URL(s) into our app connection form.

  1. 1.Go to our homepage and click "Add App"
  2. 2.Click on the "Stripe" tab
  3. 3.In the "1. Stripe Read-Only API Key" field, paste the key you copied in Step 2
  4. 4.In the "2. App Store URLs (Optional)" section, optionally enter URLs if your product has an app store presence. URLs are optional for SaaS products without app stores.
  5. 5.(Optional) Enter your X handle if you want to link your profile
  6. 6.Click "Add your app" to complete the setup
✅

That's it!

After clicking "Add your app", we'll validate your credentials and start fetching your revenue and subscription metrics. Your app should appear on the leaderboard within a few minutes.

Why do we need store URLs?

🔗

Stripe doesn't provide app information like name, icon, or store listings. We use your store URLs to:

  • •Fetch your app's name, icon, and category from the App Store or Play Store
  • •Display your app's ratings and reviews
  • •Prevent duplicate entries (we check if the same app exists via other integrations)
  • •Link to your app's store listing from your profile page

Important Notes

✅

What we access

We only read your charges (to calculate revenue) and subscriptions (to calculate MRR). We cannot create charges, modify subscriptions, access customer payment methods, or perform any write operations.

🔐

Security

Your API key is encrypted and stored securely using AES-256-GCM encryption. Never share this key publicly or commit it to version control.

📊

Data sync

We fetch your revenue and subscription data from Stripe's API. Data is updated regularly to ensure your metrics are always current. The first sync may take a few minutes to complete, especially if you have a large number of transactions.

Troubleshooting

"Invalid credentials" or "Authentication failed"

  • •Make sure you copied the entire API key without any extra spaces
  • •Verify the key starts with rk_live_ or rk_test_
  • •Check that the API key hasn't been revoked in Stripe Dashboard
  • •If using test mode, make sure you're aware that test data won't show real revenue

"Invalid URL" or "Please provide at least one URL"

  • •You must provide at least one store URL (App Store or Google Play Store)
  • •App Store URLs should start with https://apps.apple.com/
  • •Google Play URLs should start with https://play.google.com/

"This app already exists"

  • •The app with this store URL may already be registered via another integration (RevenueCat, Apple, Adapty, etc.)
  • •If you own the app, you can edit it from your dashboard
  • •Contact support if you need to merge or transfer app ownership

"Permission denied" or missing permissions

  • •Your API key may not have the required read permissions
  • •Use the link in Step 1 to create a new key with correct permissions
  • •Make sure you have Admin or Owner role in Stripe

Still having trouble?

Make sure you've completed all 3 steps above. If you're still experiencing issues, try creating a new restricted API key using the link in Step 1 and ensure you don't modify the pre-configured permissions.

← Back to Home
Privacy Policy|Terms of Service