Chargebee integration

Overview

GrowPanel's Chargebee integration allows you to import historical subscription, billing, and customer data from your Chargebee site – and keep it up-to-date in real time by listening to Chargebee webhooks. Once connected, GrowPanel builds a full picture of your subscription business: trials, MRR movements, invoices, coupons, and more.

This guide walks you through:

1. How to connect Chargebee to GrowPanel
2. How to configure Chargebee (in its UI)
3. What data GrowPanel imports
4. What to expect in the GrowPanel UI after import
5. Best practices, tips, and common pitfalls

How to connect Chargebee to GrowPanel

Here is a step-by-step process for setting up your Chargebee integration.

Step 1: Open GrowPanel

In your GrowPanel app, navigate to Integrations → Data sources → Add data source → Chargebee.

Step 2: Enter a friendly name

Give the data source a name that helps you identify it in GrowPanel (for example, "Chargebee - Production" or "Chargebee Sandbox").

Step 3: Enter your Chargebee subdomain

You need to provide your Chargebee site subdomain.

• If your Chargebee dashboard URL is mycompany.chargebee.com, then your subdomain is mycompany.
• Enter just that part (not the full URL) into the form in GrowPanel.

Step 4: Create a read-only API key in Chargebee

Next, you need a read-only API key from Chargebee, so GrowPanel can fetch your data securely.

In Chargebee:

• Log into your Chargebee account with an admin-level role.

• Go to Settings → Configure Chargebee → API Keys & Webhooks.

  

• Scroll down to the API Keys and Events section, and click "API keys".

  

• Click Add API Key.

  

• Choose Read-only, and choose "All". This gives the key full read-only access to the Chargebee account.

• Give the key a meaningful name (for your reference), for instance "GrowPanel key".

  

• Click Create Key.

• Once generated, copy the key and store it safely; you'll paste it into GrowPanel in the next step.

Step 5: Paste the API key into GrowPanel

Go back to the GrowPanel integration form, and paste the API key you just generated.

Step 6: Copy the Webhook URL from GrowPanel

Under the "Webhook URL" field in GrowPanel, your webhook URL is displayed. Click the Copy icon to save it to your clipboard. It needs to be pasted into Chargebee - see next step.

Step 7: Set up a Webhook in Chargebee

Now you need to configure webhooks in Chargebee so that real-time events are sent to GrowPanel.

In Chargebee:

• Go back to **Settings → Configure Chargebee → API Keys and Events.

• Click Webhooks.

• Click Add Webhook.

  

• In the "Webhook Name" field, enter something descriptive (e.g. "GrowPanel webhook").

• Paste the GrowPanel webhook URL into the "Webhook URL" field.

• Don't enable the "Protect webhook URL with bacis authentication"

• Make sure API version 2 is selected

• Events to Send: We recommend selecting All Events.

  

• Click "Create".

Step 8: Verify the connection from GrowPanel

Return to GrowPanel, and click "Save". We now automatically check if the API works. If everything works, your Chargebee source begins its initial import.

Step 9: Monitor the import progress

In GrowPanel, you will see an import status screen, showing you the import progress. Depending on how much data you have in Chargebee, this initial import could take minutes to hours.

Done: Live sync

After import, GrowPanel will keep listening to Chargebee events using the webhook. Future changes - new subscriptions, upgrades, cancellations, payments - will be captured in (near) real time (typically only with a few minutes delay)

What data GrowPanel imports from Chargebee

When you set up Chargebee with GrowPanel, here's the full set of data that GrowPanel will import and maintain. This gives you a rich, analytics-ready model of your subscription business.

1. Customers / Accounts

   • All customer records (including trialing, active, canceled)
   • Custom fields stored on customer records in Chargebee. They will be exposed as custom variables in GrowPanel.
   • Lead / trial creation dates (if Chargebee tracks when a customer was created and possibly associated with a trial)

2. Subscriptions

   • Subscription objects, including status (active, canceled, non-renewing, paused, etc.)
   • Subscription start, end, cancellation dates
   • Subscription plan data, including add-ons, addons quantity, tiered pricing, etc.
   • Plan catalog information (plans, add-ons, prices)
   • Plan groups, if you use grouping in your billing setup

3. MRR movements / Subscription lifecycle

   • Upgrades and downgrades (changing plan)
   • Renewals
   • Cancellations and reactivations
   • Trial starts and trial-to-paid transitions
   • Prorations, if Chargebee emits prorated invoice line items

4. Invoices and Transactions

   • Invoice creation events
   • Invoice line items (subscription lines, add-ons, usage, one-time charges)
   • Payments (when invoices are paid)
   • Refunds and credit notes
   • Taxes if Chargebee tracks them separately (metadata)

5. Discounts / Coupons

   • Coupons or discount codes applied to subscriptions
   • Coupon usage history
   • Credit note adjustments that may come from coupon credits

What to expect in GrowPanel after import

Once the import has run and GrowPanel is in sync, here is what your GrowPanel UI will show and how you can interact with the data:

1. Dashboard & Key Metrics

   • Monthly Recurring Revenue (MRR), broken down by plan, cohort, or segment
   • Number of active customers, churned customers, reactivated customers
   • Trial-to-paid conversion rate
   • Revenue movements over time (expansion, contraction, churn)
   • All subscription reports such as ARR, ARPA, ASP, LTV, churn, etc.

2. Customer Analytics

   • A full list of customers imported from Chargebee
   • Each customer's subscription history: when they joined, what plan(s) they had, upgrades or downgrades, cancellations
   • MRR history for individual customers
   • Metadata on customers, such as custom attributes from Chargebee

3. Subscription / Plan Growth

   • Performance of different plans and plan groups
   • Add-on usage trends
   • Growth or contraction in each plan category

4. Transaction & Cash Flow Data

   • Invoice volume and value over time
   • Refunds / credit notes volume
   • Payment success rates

5. MRR Movements Table

   • Detailed log of MRR-adjusting events: upgrades, downgrades, churn, reactivations, trials
   • Ability to filter or segment based on movement type or plan

Best practices & tips

Here are a few recommendations and things to watch out for when using the Chargebee integration with GrowPanel.

• Use a dedicated API key for GrowPanel.
  Don't reuse an API key intended for other systems. Create one just for GrowPanel, so you can rotate or revoke it safely without impacting other integrations.

• Monitor import progress.
  If your Chargebee account has a lot of historical data (many customers, invoices, credit notes), the import will take longer. Use the GrowPanel UI to monitor it.

• Plan for API key rotation.
  Periodically rotate your API key (every 3–6 months is a good practice), and update GrowPanel with the new key before deactivating the old one.

• Organize your plan groups
  GrowPanel imports your product catalogue automatically, and uses the plans as "Plan groups" and the prices inside each plan as "plans". This means that we don't import the Product families automatically. For this reason it's a good idea to navigate to Settings > Plan groups in GrowPanel and organize the plans and products in a way that makes most sense for your reporting.

Common pitfalls & troubleshooting

Here are some issues you might run into, and how to address them.

Summary

By connecting Chargebee to GrowPanel, you gain deep visibility into your subscription business: customers, subscriptions, invoice history, MRR movements, and more. The integration uses a read-only API key and a webhook, so your data is imported securely and kept current in real time.

Once set up, GrowPanel surfaces key metrics across customers, subscription plans, revenue flows, and lifecycle events – giving you the insights you need to understand growth, churn, and expansion.

If you run into issues or need help interpreting your data in GrowPanel, our support team is ready to assist.