> ## Documentation Index
> Fetch the complete documentation index at: https://docs.introw.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Connect Chargebee billing

> Connect Chargebee with your site name and API key so Introw can import subscriptions, customers, and invoices to power partner commissions.

Connecting Chargebee brings subscription, customer, and invoice data into Introw so commissions calculate on what customers are actually billed, not just CRM deal amounts. This is the right source when recurring revenue drives partner payouts. Unlike Stripe's OAuth, Chargebee connects with your site name and an API key. This guide gets Chargebee importing and points you to mapping and linking the data so commissions can use it. The integration is import-only and never charges customers.

## What you'll achieve

A connected Chargebee site importing billing data into Introw, ready to map and link to partners so commission plans can pay on actual recurring revenue.

## Before you start

<Steps>
  <Step title="Enable the billing module">
    Billing integrations are a paid add-on. If the Chargebee tile shows **Upgrade plan**, the billing integrations module is not enabled on your plan; contact Introw to add it.
  </Step>

  <Step title="Get your Chargebee credentials">
    Have your Chargebee site name (the subdomain in your-site-name.chargebee.com) and a Chargebee API key. You need permission to connect integrations in Introw; credentials are stored encrypted.
  </Step>
</Steps>

## Watch it

<Tabs>
  <Tab title="Video">
    <video controls playsInline preload="none" poster="https://assets.introw.io/docs/features/integrations/billing/guides/connect-chargebee/steps/01.png?v=1783331520" className="w-full rounded-xl" src="https://assets.introw.io/docs/features/integrations/billing/guides/connect-chargebee/video.webm?v=1783331520#t=2.5" />
  </Tab>

  <Tab title="Click through">
    <iframe className="w-full rounded-xl" style={{ width: "100%", aspectRatio: "16 / 11", border: 0, backgroundColor: "#FAFAFA" }} src="https://assets.introw.io/docs/features/integrations/billing/guides/connect-chargebee/walkthrough.html?v=1783331520" />
  </Tab>
</Tabs>

## Steps

<Steps>
  <Step title="Open the Billing integrations">
    Go to [Integrations](https://app.introw.io/settings/integrations?category=billing) and stay on the **Billing** category.

    <Frame>
      <img src="https://assets.introw.io/docs/features/integrations/billing/guides/connect-chargebee/steps/01.png?v=1783331520" alt="Open the Billing integrations" />
    </Frame>
  </Step>

  <Step title="Enter your credentials">
    On the **Chargebee** tile select **Connect** to open the **Chargebee Integration** dialog, then fill in the **Credentials**:

    * **Chargebee Site** - your Chargebee site name, entered between the shown https\:// and .chargebee.com (for example "your-site-name"). This tells Introw which Chargebee account to read from.
    * **API Key** - a Chargebee API key with read access. Introw uses it to import billing data; it is stored encrypted.

    <Frame>
      <img src="https://assets.introw.io/docs/features/integrations/billing/guides/connect-chargebee/steps/02.png?v=1783331520" alt="Enter your credentials" />
    </Frame>
  </Step>

  <Step title="Connect">
    Select **Connect**. Introw validates the credentials and confirms Chargebee is connected. If you see an invalid-key or site-not-found message, recheck the site name and API key; if the site is already linked to another organisation, it cannot be connected twice.

    <Frame>
      <img src="https://assets.introw.io/docs/features/integrations/billing/guides/connect-chargebee/steps/03.png?v=1783331520" alt="Connect" />
    </Frame>
  </Step>

  <Step title="Map and link the data">
    Connecting only brings Chargebee in; next, choose which billing objects to import and link them to partners. Follow [Connect your billing data](./connect-billing-data) to finish, then the data is available to commission plans.
  </Step>
</Steps>

## Verify it worked

Chargebee shows as **Connected** on the Billing integrations page and the billing configuration page opens. After you map and link records, the Chargebee source becomes selectable when [building a commission plan](/features/commissions/commission-plans/guides/build-and-launch-a-commission-plan).

## Related

<CardGroup cols={2}>
  <Card title="Connect your billing data" icon="book-open" href="./connect-billing-data">
    Map billing objects and link records to partners.
  </Card>

  <Card title="Connect Stripe billing" icon="book-open" href="./connect-stripe">
    Use Stripe instead of Chargebee.
  </Card>

  <Card title="Build and launch a commission plan" icon="book-open" href="/features/commissions/commission-plans/guides/build-and-launch-a-commission-plan">
    Pay partners on the imported billing data.
  </Card>

  <Card title="Implementation reference" icon="screwdriver-wrench" href="../technical">
    Full configuration options.
  </Card>
</CardGroup>
