Skip to main content
A connected billing system only powers commissions once the right records are imported and tied to partners. Authorizing Stripe or Chargebee imports nothing on its own, which is the single most common reason a billing setup looks finished and produces no commissions. This guide takes a connected integration the rest of the way: choose which billing objects to import, tell Introw which property identifies the partner on each, auto-link records to partners in bulk, and then use that data in a commission plan. 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, and a commission plan that can select that provider as its source, pick the mapped object, and condition on real billing fields, so partners are paid on invoices that were actually collected rather than on every invoice raised.

​
Before you start

1

Connect a billing system

Stripe or Chargebee must be connected. See Connect Stripe billing or Connect Chargebee billing.
2

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.

​
Steps

​
Import the billing objects

1

Open the billing configuration

Go to Integrations and select Configure on the connected provider to reach its billing configuration page. The header shows the connection state (Connected by whoever authorized it, or Syncing while an import runs), a Sync now button, and the option to disconnect.The left panel is Object Linking: the list of billing objects Introw imports and attributes to partners. On a fresh connection it is empty and says so. Nothing at all is imported until you add an object here, which is the step most setups miss.
2

Add an object to import

Select Add object and complete the three fields:
  • 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 on product catalog v1 or Item and Item Price on v2 (Introw reads your catalog version and only offers the ones that apply). For revenue commissions, Invoice is the usual answer, because an invoice is what proves the customer was actually billed. Choose Subscription when you pay on recurring contract value instead of collected invoices.
  • Which property identifies the partner? - the provider API field Introw reads to decide which partner a record belongs to. The dropdown lists the fields Introw knows for that object, so on a Stripe invoice you can attribute through Customer, Customer Email, or Customer Name. If your partner id lives somewhere Introw cannot enumerate, select Can’t find your field? Use manual input and type the exact API field name; the placeholder shows the shape expected per provider (metadata.partner_id for Stripe, cf_partner_id for Chargebee).
  • Display label - what this property is called in Introw, for example “Partner ID”. Your team sees this label on the mapping screen and on imported records, so name it after what it means, not after the API field.
Pick a property that points at the customer, not at the invoice itself, unless you genuinely stamp a partner id on every invoice. Customer-level attribution survives new invoices automatically; per-invoice attribution has to be right on every future record.
3

Save and let it sync

Select Add object. Introw confirms with “A full sync has been triggered” and starts importing that object; the header switches to Syncing while it runs. Repeat for each object your commissions need, and use Sync now any time you want to refresh on demand rather than wait for the scheduled sync.Removing an object later is also here: the trash icon on a row deletes the mapping and, with it, all partner-related objects of that type from your partner portals. It can be added back, but the partner-facing records disappear in the meantime.
Importing tells Introw which records to read. Linking tells it whose they are. Until a partner has a value here, their billing records are imported but unattributed, and a commission plan will calculate nothing for them.
1

Open the selected object's mapping

Select an imported object in Object Linking to open its panel on the right. Two things are on it:
  • Attribution property - a read-only confirmation of the field you chose, shown as the display label with the API field name beside it. This is what every match below is keyed on.
  • Match property values to Introw partners - a table of every partner in your account with an editable value column, titled with your display label. The value you put on a partner’s row is the billing value that resolves to them. Use the search box to work a long partner list.
Two states in this table stop a row from being set, and both are worth knowing before you start:
  • “Partner not linked to a CRM object” on an amber row - that partner has no CRM record behind it, so it cannot carry a billing link. The row links straight to the partner so you can fix it; the value field only becomes editable afterwards.
  • “This value is already assigned to <partner>” in red - a billing value maps to exactly one partner. Introw refuses the duplicate rather than splitting revenue across two partners silently.
If the property you mapped is a fixed-option field, the cell becomes a picker of the real values rather than a free-text box, and values already taken by another partner are marked as such.
2

Auto-detect partner links

Typing a value per partner does not scale past a handful, so select Auto-detect to open Auto-detect partner links. Introw scans the imported billing records, compares them against your partners, and proposes only the matches it is confident about. Four counters frame the result: Scanned records, Candidates found in the billing data, Missing partners it could not place, and links Found.What it actually matches on, so you can predict its answers:
  • It scans the object your property points at. Map a Stripe invoice through Customer and it compares Stripe customers against your partners; map a property on the record itself and it compares those records.
  • It matches on identifiers, domains, and names, in that order of trust. A domain match scores highest, an exact name next, a close name lower.
  • It only proposes matches above 80% confidence, and each suggestion carries its reason and score (for example “Domain match · 95%”), so you can see why before accepting.
  • It only fills gaps. Partners who already have a value are skipped and existing manual links are never overwritten. Billing values already claimed by another partner are excluded too.
  • It skips partners with no CRM record, the same amber rows above, which is the most common reason a partner shows up under Missing.
If it returns nothing, it tells you to sync more data or map a property that points at customers. Both are usually the real fix; re-running will not help on its own.
3

Apply the links

Every suggestion starts selected. Deselect anything you disagree with, then choose Apply selected; Introw writes them in bulk and confirms with the count of partner links added. Set the rest by hand in the match table, and expect a tail: partners with no billing footprint yet, and partners whose billing account name looks nothing like their partner record.

​
Use it in a commission plan

This is where the setup pays off, and where a half-finished mapping shows up:
1

Pick the billing source

In the commission plan wizard’s Connect your data step, Stripe and Chargebee sit alongside your CRM as data sources. An unconnected provider is shown but not selectable: it offers Connect instead, or Upgrade plan when the billing integrations module is not on your plan.
2

Pick the object and the date field

Select object where the commission data is stored lists only the objects you mapped above. If you skipped Object Linking, this dropdown is empty and points you back to billing settings; nothing else in the wizard can rescue that. Introw preselects Invoice when it is mapped, since that is what most plans pay on.Commission date field decides which period a commission falls in, and defaults to the object’s created date (created on Stripe objects). Change it when you recognize revenue on a different date, for example a Stripe invoice’s Period Start for subscription revenue or Due Date for collections-based payouts.
3

Condition on the billing data

The Conditions step then filters on the imported provider fields, which is how you keep a plan honest. On a Stripe invoice you can gate on Status (draft, open, paid, uncollectible, void), Paid, Amount Paid, Total, Subtotal, Tax, Currency, Billing Reason, Collection Method, and the date fields. The condition nearly every revenue plan wants is Status is paid (or Paid is true), so partners are credited on money collected rather than on invoices that were later voided or written off.The wizard’s data preview runs your conditions against real imported records over a 90, 180, or 365 day window, so you can confirm the filter selects what you expect before the plan generates a single commission line. See Build and launch a commission plan and Set eligibility conditions.

​
Verify it worked

Three checks, in the order they fail:
  1. Object Linking lists each object you added with its partner property underneath, and the header is back to Connected rather than Syncing.
  2. The Match property values to Introw partners table shows a value on every partner you expect to pay, with no amber “not linked to a CRM object” rows left among them.
  3. In the commission plan wizard, selecting Stripe or Chargebee offers your mapped objects in Select object where the commission data is stored, and the data preview returns real records once your conditions are set. That last one is the real proof: it means imported, attributed, and filterable, so partners are credited for the revenue they drove.

Connect Stripe billing

Connect Stripe before mapping.

Connect Chargebee billing

Connect Chargebee before mapping.

Build and launch a commission plan

Pay partners on the linked billing data.

Set eligibility conditions

Gate a plan on paid invoices instead of every invoice raised.

Implementation reference

Full configuration options.