> ## 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.

# Billing & Subscriptions

> Connect Stripe or Chargebee, map billing objects and partner links, sync, and use billing data in commissions in Introw.

**Open in Introw:** [Integrations](https://app.introw.io/settings/integrations?category=billing)

## How it works

Stripe and Chargebee appear as tiles on the Billing tab. You connect your billing system, then define
which billing objects, customers, subscriptions, invoices, products, and prices, to import and how
their properties map. You link billing records to partners so revenue is attributed correctly, and a
background import keeps the data current; you can also trigger a sync manually.

Once imported, billing data becomes a data source you can select when building a commission plan, so
commissions calculate on real revenue. This is import-only into Introw; your billing system continues
to charge customers.

```mermaid theme={"theme":{"light":"github-light","dark":"github-dark"}}
flowchart LR
  billing["Stripe or Chargebee"] --> introw["Introw"]
  introw --> link["Linked to partners"]
  link --> commissions["Commission source"]
```

## Prerequisites

* The billing integrations module enabled on your plan.
* Admin access to your Stripe account.
* Integrations write access.

## Settings & configuration

Stripe is managed at [Integrations](https://app.introw.io/settings/integrations?category=billing).

### Connect a billing system

Use the Stripe tile to connect via OAuth (choosing live or test mode), or the Chargebee tile to
connect your Chargebee site.

### Billing object mappings

Define which billing objects to import and how their properties map into Introw.

### Partner links

Map a billing property to link billing records to the right partner; preview and bulk-apply
auto-links.

### Sync

Imports run on a schedule; use the manual Sync action to refresh on demand.

### Use in commissions

Select the Stripe source when building a commission plan to pay on billing data.

## Setup walkthrough

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

  <Step title="Connect Stripe">
    Authorize via OAuth in live or test mode.
  </Step>

  <Step title="Map objects and links">
    Choose billing objects and link records to partners.
  </Step>

  <Step title="Sync and use">
    Sync, then use the data in a commission plan.
  </Step>
</Steps>

## How-to guides

<CardGroup cols={2}>
  <Card title="Connect your billing data to partners" icon="book-open" href="/features/integrations/billing/guides/connect-billing-data">
    Choose which billing objects to import from Stripe or Chargebee, identify the partner on each, and auto-link records so revenue attributes correctly.
  </Card>

  <Card title="Connect Chargebee billing" icon="book-open" href="/features/integrations/billing/guides/connect-chargebee">
    Connect Chargebee with your site name and API key so Introw can import subscriptions, customers, and invoices to power partner commissions.
  </Card>

  <Card title="Connect Stripe billing" icon="book-open" href="/features/integrations/billing/guides/connect-stripe">
    Authorize Stripe in live or test mode so Introw can import customers, subscriptions, and invoices to power partner commissions.
  </Card>
</CardGroup>

## Limits & gotchas

<Warning>
  Billing integrations require the module to be enabled on your plan. The integration imports billing data into Introw; it does not charge customers or execute payouts. Test mode is useful for setup, but commissions should run on live data. Records only contribute to commissions once linked to a partner.
</Warning>

## Troubleshooting

* **The Stripe tile shows an upgrade prompt** - the billing integrations module is not enabled.
* **Revenue is not attributed** - billing records are not linked to a partner.
* **Data is stale** - trigger a manual sync, or check the scheduled import status.