# Chargebee

> Chargebee is a subscription billing and revenue management platform.

Chargebee shows you subscription metrics and revenue dashboards, but understanding which marketing campaigns drive your highest-value subscribers or how customer acquisition costs compare to lifetime value requires connecting billing data to your ad platforms and CRM.

Filament links Chargebee to your marketing and analytics tools so you can explore subscription economics, cohort performance, and revenue attribution without manual exports.

## Data we sync

- **Subscriptions**: Track subscription lifecycle with subscription_id, plan_id, status, current_term_start, current_term_end, billing_period, and mrr. See which plans drive the most revenue and when customers are likely to churn. (`subscription_id`, `plan_id`, `status`, `mrr`, `current_term_end`, `billing_period`)
- **Customers**: Analyze customer profiles with customer_id, email, created_at, billing_address, payment_method, and customer_type. Connect to your CRM to see which acquisition channels bring in the highest-value subscribers. (`customer_id`, `email`, `created_at`, `billing_address`, `payment_method`)
- **Invoices**: Track billing activity with invoice_id, subscription_id, total, amount_due, status, date, and line_items. Understand payment timing and identify revenue recognition patterns across your customer base. (`invoice_id`, `subscription_id`, `total`, `status`, `date`, `line_items`)
- **Transactions**: Monitor payment flows with transaction_id, invoice_id, amount, payment_method, status, date, and gateway. Spot failed payments early and analyze which payment methods have the highest success rates. (`transaction_id`, `invoice_id`, `amount`, `payment_method`, `status`, `gateway`)
- **Credit Notes**: Track refunds and adjustments with credit_note_id, customer_id, total, reason_code, date, and line_items. Understand why customers request refunds and which products have the highest return rates. (`credit_note_id`, `customer_id`, `total`, `reason_code`, `date`)
- **Coupons and Credits**: Analyze promotional effectiveness with coupon_id, discount_type, discount_amount, duration, redemptions, and promotional_credits. See which offers drive conversions and calculate the true cost of acquisition. (`coupon_id`, `discount_type`, `discount_amount`, `duration`, `redemptions`)
- **Subscription Items**: Break down subscription components with item_id, subscription_id, item_price_id, quantity, unit_price, and amount. Understand which add-ons and features customers value most. (`item_id`, `subscription_id`, `item_price_id`, `quantity`, `amount`)
- **Plans and Addons**: Review product catalog with plan_id, name, price, period, addon_id, and pricing_model. Compare plan performance and identify which pricing structures convert best. (`plan_id`, `name`, `price`, `period`, `pricing_model`)

## How do I connect Chargebee?

You need a Chargebee **Admin or Owner** account. Check which Product Catalog version your site currently uses; it may have changed since the site was created.

1. In Chargebee, open **Settings → Configure Chargebee → API Keys and Webhooks → API Keys**.
2. Select **Add API Key → Read-only Key → All**. Name the key, select **Create Key** and copy it.
3. Note your site’s subdomain: for `example.chargebee.com`, enter `example`.
4. Open [Apps](https://filamentanalytics.com/apps) in Filament and add **Chargebee**. Use the connection for your site’s Product Catalog version.
5. Enter the API key and subdomain, select **Save & Test**, then return to Filament and complete setup.

For Product Catalog 2.0, syncing ramps requires Chargebee to enable the **Ramp** feature on your account. Ask your Chargebee account manager if it is unavailable.
