Set Up Your Program

Complete these steps before you invite partners or install tracking.

What you are setting upCopy Anchor Link

1. Program details: business info, approval settings, commission rules
2. Tracking & integrations: click, signup, and sale tracking
3. Go live: publish the program once payments are connected
4. Share program: your partner-facing program link

1. Program detailsCopy Anchor Link

Business detailsCopy Anchor Link

Approval modeCopy Anchor Link

Commission detailsCopy Anchor Link

Common options: one-time, fixed-month recurring, or lifetime.

2. Tracking & IntegrationsCopy Anchor Link

Set up tracking in three steps: clicks, signups, then payments.

Step 1 — Pageview / click trackingCopy Anchor Link

Install the tracker on pages where affiliate traffic lands.

SDK:

npm install @affitor/sdk

// app/providers.tsx — client component
'use client';
import { useEffect } from 'react';
import { loadAffitor } from '@affitor/sdk';
export function AffitorInit() {
  useEffect(() => { loadAffitor('YOUR_PROGRAM_ID'); }, []);
  return null;
}
// render <AffitorInit /> once in app/layout.tsx

Script tag:

<script
  src="https://api.affitor.com/js/affitor-tracker.js"
  data-affitor-program-id="YOUR_PROGRAM_ID"
  data-affitor-debug="false">
</script>

→ Full guide

Step 2 — Signup / lead trackingCopy Anchor Link

After signup succeeds, send your internal customer ID to Affitor.

Browser helper:

await window.affitor.signup('user_123', 'user@example.com');

By default a browser-only lead is provisional: it counts once your server sends the lead (below) or a Stripe Checkout payment for that customer arrives through your connected Stripe account.

Server API:

{
  "click_id": "cust_42_1234567890",
  "customer_key": "user_123",
  "email": "user@example.com"
}

→ Full guide

Step 3 — Sale / payment trackingCopy Anchor Link

Choose the path that matches your checkout.

For Stripe integration, use these public fields in metadata:

• affitor_click_id
• affitor_customer_key
• program_id

For subscriptions, put the same values in both:

• metadata
• subscription_data.metadata

→ Full guide

3. Go liveCopy Anchor Link

Go live publishes your program on the marketplace and lets you invite partners. It needs three things:

Payments counts as connected in one of two ways, matching the method you chose on the Payments step:

• Stripe: your Stripe account is connected to the program.
• Server API: your server has sent at least one sale for this program to POST /api/v1/track/sale. A test sale counts (send it with "livemode": false), so you can go live before your first real customer. The Payments step waits for that sale and says when it reached Affitor. The dashboard's Run check (Check Affitor's tracking) is a pipeline check and does not count; the sale has to come from your server.

Click and signup tracking are not required to go live. Install them before you invite partners so their traffic is attributed.

If the program is paused for an overdue invoice, pay the invoice first; Go live stays blocked until then.

4. Share Your ProgramCopy Anchor Link

Once the program is live, share your partner recruitment link so affiliates can apply.

Recommended setup orderCopy Anchor Link

Verify it workedCopy Anchor Link

Reload Settings and confirm each choice survived the save. Each page (Business, Commission) saves on its own: