Stripe

The Stripe integration is the most powerful and complete way to use GrowPanel. Because Stripe is a flexible billing platform with a deep data model, GrowPanel imports far more than just customers and subscriptions. It reconstructs your entire billing history, calculates accurate MRR and CMRR, handles complex pricing cases, and updates your analytics in real time as Stripe events occur.

Connecting Stripe takes only a few clicks. There are no API keys to copy, no webhooks to configure manually, and no server settings to adjust. You simply choose a data source name, click Connect, approve the read only permissions in Stripe, and GrowPanel begins importing your data immediately.

This guide covers every step of the setup and explains exactly what GrowPanel imports from your Stripe account. It also explains how GrowPanel handles advanced cases like multi-currency billing, discounts, tiered pricing, metered usage, scheduled cancellations, free trials, billing proration, and more.

Before you begin

To integrate Stripe with GrowPanel you need:

• Access to your Stripe dashboard
• Permission to authorize OAuth apps
• If you manage multiple Stripe accounts, the ability to choose which one to connect

You do not need to find or manage API keys. The entire setup uses OAuth.

Step 1: Start a new Stripe data source in GrowPanel

From inside GrowPanel, go to Settings > Integrations > Add new data source and choose Stripe.

If you are connecting Stripe during the onboarding flow, GrowPanel will automatically use your Stripe account name as the data source name. If you are connecting later, you will be asked to provide a name yourself. You can call it something descriptive such as:

• Stripe Production
• Stripe EU
• Stripe Main Account
• Stripe App Revenue

This name is for your internal use only. Once you enter it, click Next.

Step 2: Approve the Stripe OAuth permissions

After clicking Connect, you will be redirected to Stripe. Stripe shows a standard OAuth screen that explains exactly which permissions GrowPanel needs. All of these are read only and safe to grant. GrowPanel cannot modify subscriptions, charge customers, or create invoices. It can only read data.

The read-only permissions typically include:

• Account and user information
• Accounts
• Payouts
• Plans
• Products
• Invoices
• Events
• Disputes
• Customers
• Credit Notes
• Charges
• Balances
• Subscriptions
• Tax Rates

Stripe clearly indicates that GrowPanel will not be able to perform write actions.

Select the account you wish to connect (if you manage multiple). Then click Continue.

When you complete this step, Stripe redirects you back to GrowPanel, where the import begins automatically.

Step 3: GrowPanel verifies your account and starts importing

There is nothing else you need to configure. As soon as you return to GrowPanel, you will see the integration status switch to connected. GrowPanel immediately begins the initial import of your Stripe data.

You will see a progress screen that first needs to discover your customers in Stripe, and then process them. Stripe has a rate-limited API so this can take anywhere from a few minutes to hours, depending on the size of your data.

The import runs in the background so you can navigate elsewhere in GrowPanel or close your browser. The process will continue until your full history is imported, and you'll get and email once it's fully imported.

What GrowPanel imports from Stripe

Stripe is highly flexible and supports many billing models. GrowPanel takes advantage of this by building a complete view of your subscription business. Below is an in depth overview of what GrowPanel imports and how each type of data is used.

Products and prices

In Stripe, the product object identifies what you sell, while the price object defines how that product is billed.

GrowPanel imports:

• All products (active and archived)
• All prices (recurring and one time)
• Currency per price
• Billing interval (monthly, yearly, weekly, custom)
• Recurring type (licensed, metered, tiered, graduated, volume)
• Tier definitions
• Legacy prices and archived items

GrowPanel uses this information to understand how each subscription is structured and how MRR should be calculated. For example:

• A price with a monthly billing interval creates standard MRR
• A metered price uses usage records to determine actual monthly revenue
• A tiered price needs special calculation rules since the unit cost changes with usage
• Multi currency prices are converted correctly for global reporting

If you change pricing or launch a new plan, GrowPanel automatically reflects those changes in your analytics.

Customers

GrowPanel imports all customers from Stripe, including:

• Email
• Name
• Billing country
• Stripe customer ID
• Metadata (all custom metadata fields you have created)
• Date of creation

Metadata is particularly valuable for filtering and segmentation. For example, many businesses store custom fields like:

• Account manager
• Sales region
• Internal customer type
• Hubspot or Salesforce IDs
• Feature flags
• Plan category

GrowPanel includes all metadata fields in customer profiles so you can filter and group your analytics in flexible ways.

Invoices

GrowPanel imports:

• Invoice amounts
• Line items
• Prorations
• Discounts
• Taxes
• Currency
• Invoice status (paid, uncollectible, void, draft)
• Automatic tax and inclusive tax fields
• Credits applied
• Invoice creation and payment dates

Invoices are used as the main data to build MRR movements and transactions in GrowPanel.

Charges

GrowPanel imports charges, which represent actual attempts to collect money. This helps show:

• Cash collection
• Failed payments
• Refunds
• Disputes
• Charge outcomes
• Payment methods

Charges are used to build the transactions reports, and show successful and failed payments.

Subscriptions

GrowPanel imports:

• Subscription status (active, trialing, canceled, incomplete, paused, past due, unpaid)
• Start and end dates
• Trial periods
• Cancellation dates
• Scheduled cancellation (cancel at period end)
• The reason for cancellation (if provided via Stripe's cancel reasons feature)
• Quantity
• All attached prices
• Discounts applied to the subscription
• Pause and resume events
• Incomplete or pending invoice states
• Subscriptions upgraded or downgraded mid cycle
• Automatic prorations

Most historical subscription data is already imported via the invoices, but we also import the subscriptions directly because they are needed to know if a subscription is cancelled or changed since last invoice.

Discounts, coupons, and promotional pricing

GrowPanel imports all discount related data including:

• Coupon codes
• Percentage and amount discounts
• Free periods
• Time limited discounts
• Discounts attached to subscriptions
• Discounts applied to invoices
• Duration based discounts (once, repeating, forever)

GrowPanel uses discounts when calculating CMRR. For example:

• If a customer has a discount that expires next month, GrowPanel forecasts the revenue increase in CMRR.
• Discounts that permanently reduce price are treated differently from promotional discounts that phase out.

This is vital for accurate future revenue forecasting.

Trials and free trial conversions

GrowPanel imports:

• Trial start and end dates
• Trial length
• Trial to paid conversion events
• Customers who churn during a trial
• Conversions from free to paid at different intervals

These appear in trial conversion reports and help you optimize your onboarding funnel.

Prorations

When a customer upgrades or downgrades mid cycle, Stripe generates proration adjustments. GrowPanel imports all proration line items to provide accurate MRR movement calculations.

For example:

• Upgrades mid cycle can create a one time increase
• Downgrades can result in credits
• Switching from annual to monthly creates adjustments
• Adding add ons mid period generates proration charges

GrowPanel uses these to reconstruct accurate customer revenue histories.

Metered and usage based billing

Stripe supports usage based pricing using usage records. GrowPanel imports usage data for all metered prices.

This allows GrowPanel to:

• Calculate MRR accurately for usage based models
• Show monthly usage revenue
• Rebuild historical usage patterns
• Handle graduated or tiered metered plans

This is especially important for API based or consumption based products.

Currency support

GrowPanel fully supports multi currency Stripe setups. GrowPanel imports currency for every price, charge, line item, and invoice.

Depending on your settings, prices may be:

• Displayed in their original currency
• Normalized into a single reporting currency

This gives you accurate global reporting across currencies like USD, EUR, GBP, AUD, and dozens more.

Voluntary churn, delinquent churn, and scheduled churn

GrowPanel distinguishes between:

Voluntary churn

When a customer intentionally cancels a subscription.

Delinquent churn

When a subscription cancels due to failed payments or unpaid invoices. GrowPanel identifies these automatically from Stripe's invoice and charge history.

Scheduled churn

When users click "Cancel at period end" inside your product or customer portal. GrowPanel imports:

• Cancel at period end flags
• Effective cancellation dates

Scheduled churn appears in your CMRR reports so you can see revenue that is expected to churn next month.

GrowPanel also imports Stripe cancellation reasons (if enabled). These are displayed in customer timelines and churn summaries.

Real time updates using Stripe webhooks

Using webhooks, GrowPanel receives Stripe events automatically and updates the reports within a few minutes. You do not need to configure any webhooks manually.

GrowPanel subscribes to events such as:

• customer.updated
• subscription.created, updated, deleted
• invoice.created, finalized, paid, payment_failed
• charge.succeeded, charge.failed, charge.refunded
• coupon.updated
• price.updated
• product.updated

This keeps your dashboard fully synced in real time.

What to expect in GrowPanel after integrating Stripe

Once the initial import finishes, your GrowPanel dashboard is fully populated with near complete metrics and reports.

Subscription metrics

• Total MRR
• New, Expansion, Contraction, Churn, Reactivation
• Cohorts
• Retention curves
• CMRR (forecasted revenue considering discounts ending and scheduled churn)
• Plan performance

Financial reporting

• Cash collected
• Charges and refunds
• Failed payments
• Invoice level reporting
• ARPU and LTV
• Multi currency support

Advanced billing insights

• Usage based revenue analytics
• Trial conversion reports
• Discount lifespan insights
• Proration tracking
• Scheduled churn outlook

Customer timeline

Every customer includes:

• Subscription events
• All MRR movements
• Payment history
• Discount history
• Metadata
• Cancellation reasons
• Account notes

This gives you a complete narrative of each customer's revenue journey.