Stripe Integration

How to get there: Go to Settings in the sidebar → Integrations tab (under Other) → Stripe section.

Automatically sync customer data from Stripe to enrich user profiles with MRR, LTV, plan information, and subscription status.

Setup

  1. Go to Settings > Integrations
  2. Find the Stripe section
  3. Enter your Stripe Secret API Key (starts with sk_live_ or sk_test_)
  4. Click Save

You can find your API key in your Stripe Dashboard under Developers > API keys.

Linking Users to Stripe

To sync data for a user, you need to link them to their Stripe Customer ID. There are several ways to do this:

Option 1: Bulk Upload

The easiest way to link many users at once:

  1. Go to Users > Bulk Import/Update
  2. Prepare a CSV with columns: email, stripe_customer_id
  3. Upload the file
  4. Users will be matched by email and their Stripe data will sync automatically

Example CSV:

email,stripe_customer_id
john@example.com,cus_abc123
jane@example.com,cus_def456

Option 2: SSO

If you use Single Sign-On, include the Stripe Customer ID in your JWT payload:

{
 "email": "john@example.com",
 "stripe_customer_id": "cus_abc123"
}
The Stripe data will sync automatically when the user logs in.

Option 3: API

When creating or updating users via the API, include the stripe_customer_id field:

{
 "email": "john@example.com",
 "stripe_customer_id": "cus_abc123"
}

What Data Is Synced

Once a user is linked to Stripe, the following data is automatically fetched:

FieldDescription**MRRMonthly Recurring Revenue from active subscriptionsLTVLifetime Value (total amount paid)PlanName of the current subscription planStatusSubscription status (active, past_due, canceled, trialing)Signup Date**When the customer was created in Stripe

Automatic Syncing

Stripe data is automatically synced when:

  • A user's Stripe Customer ID is added or changed
  • You manually trigger a sync from the user's profile

Manual Sync

To refresh a user's Stripe data:

  1. Go to Users and click on a user
  2. Click the Sync from Stripe button
  3. The latest data will be fetched from Stripe

Using Stripe Data

Filtering Users

In the Users list, you can filter by:

  • MRR range (min/max)
  • LTV range (min/max)
  • Plan type
  • Customer status

Searching by Stripe ID

You can search for users by entering their Stripe Customer ID (e.g., cus_abc123) in the search box.

Displaying Columns

Enable Stripe-related columns in the Users list:

  1. Click the Columns dropdown
  2. Enable: MRR, LTV, Plan, Customer Status, Stripe Customer ID

Finding Stripe Customer IDs

To find a customer's Stripe ID:

  1. Go to your Stripe Dashboard
  2. Click on a customer
  3. The Customer ID is shown at the top (starts with cus_)

Or export your customers from Stripe and use the bulk upload feature.

Troubleshooting

Data Not Syncing

  • Verify your Stripe API key is correct in Settings > Integrations
  • Check that the Stripe Customer ID is valid and exists in your Stripe account
  • Ensure the user's email in ProductLift matches the customer in Stripe

MRR Shows $0

  • The customer may not have an active subscription
  • The subscription may be on a free plan ($0/month)
  • Check the customer's subscriptions in your Stripe Dashboard