> ## 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 your billing data to partners

> Choose which billing objects to import from Stripe or Chargebee, identify the partner on each, and auto-link records so revenue attributes correctly.

A connected billing system only powers commissions once the right records are imported and tied to partners. This guide takes a connected Stripe or Chargebee integration the rest of the way: choose which billing objects to import, tell Introw which property identifies the partner on each, and auto-link records to partners in bulk so revenue attributes correctly. Do this once and your commission plans have clean, partner-attributed billing data to calculate against. The steps are the same for Stripe and Chargebee; only the object and field names differ.

## What you'll achieve

Imported billing objects (customers, subscriptions, invoices, and more) linked to the right partners, so partner-attributed revenue is available as a source for commission plans and partner insights.

## Before you start

<Steps>
  <Step title="Connect a billing system">
    Stripe or Chargebee must be connected. See [Connect Stripe billing](./connect-stripe) or [Connect Chargebee billing](./connect-chargebee).
  </Step>

  <Step title="Know your partner identifier">
    Decide which billing field tells you the partner, for example a custom field or metadata value that holds a partner id, so Introw can match records to partners.
  </Step>
</Steps>

## Watch it

<Tabs>
  <Tab title="Video">
    <video controls playsInline preload="none" poster="https://assets.introw.io/docs/features/integrations/billing/guides/connect-billing-data/steps/01.png?v=1783331520" className="w-full rounded-xl" src="https://assets.introw.io/docs/features/integrations/billing/guides/connect-billing-data/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-billing-data/walkthrough.html?v=1783331520" />
  </Tab>
</Tabs>

## Steps

### Import the billing objects

<Steps>
  <Step title="Open the billing configuration">
    Go to [Integrations](https://app.introw.io/settings/integrations?category=billing) and open the connected provider with **Configure** to reach its billing configuration page. The **Object Linking** panel lists which billing objects are imported; it starts empty.

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

  <Step title="Add an object to import">
    Select **Add object** and complete the modal:

    * **Which object do you want to import?** - the billing object to bring in. Stripe offers Customer, Subscription, Invoice, Product, and Price; Chargebee offers Subscription, Customer, and Invoice (plus Plan or Item and Item Price depending on your product catalog version). Add the objects your commissions need, usually invoices or subscriptions for revenue.
    * **Which property identifies the partner?** - the billing API field used to match the record to a partner. Pick it from the list, or select **Can't find your field? Use manual input** and type the exact field name (for example a metadata or custom field that holds a partner id).
    * **Display label** - how this property appears in Introw, so your team recognizes it (for example "Partner ID").

    <Frame>
      <img src="https://assets.introw.io/docs/features/integrations/billing/guides/connect-billing-data/steps/02.png?v=1783331520" alt="Add an object to import" />
    </Frame>
  </Step>

  <Step title="Save and let it sync">
    Select **Add object**. Introw triggers a full sync to import that object. Add each object you need; use **Sync now** in the header any time to refresh on demand.

    <Frame>
      <img src="https://assets.introw.io/docs/features/integrations/billing/guides/connect-billing-data/steps/03.png?v=1783331520" alt="Save and let it sync" />
    </Frame>
  </Step>
</Steps>

### Link records to partners

<Steps>
  <Step title="Open the selected object's mapping">
    Select an imported object to open its mapping panel. The **Attribution property** shows the field used to attribute partners, and **Match property values to Introw partners** lets you set, per partner, the billing value that should resolve to them, so imported records attribute to the correct partner.
  </Step>

  <Step title="Auto-detect partner links">
    Select **Auto-detect** to open **Auto-detect partner links**. Introw scans your imported billing data and proposes confident matches, showing how many records were **Scanned**, the **Candidates** and **Missing**, and the links **Found**. This saves mapping each value by hand.
  </Step>

  <Step title="Apply the links">
    Review the proposed links, then select **Apply selected** to create them in bulk. Introw confirms how many partner links were added. If a partner is not linked to a CRM object, the panel flags it so you can fix the partner record first. Set any remaining values manually in the match table.
  </Step>
</Steps>

## Verify it worked

Each imported billing record shows its linked partner, the **Object Linking** panel lists your imported objects with their partner property, and the billing source can be selected when [building a commission plan](/features/commissions/commission-plans/guides/build-and-launch-a-commission-plan), so partners are credited for the revenue they drove.

## Related

<CardGroup cols={2}>
  <Card title="Connect Stripe billing" icon="book-open" href="./connect-stripe">
    Connect Stripe before mapping.
  </Card>

  <Card title="Connect Chargebee billing" icon="book-open" href="./connect-chargebee">
    Connect Chargebee before mapping.
  </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 linked billing data.
  </Card>

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