Set Up Your Program
Configure your affiliate program and choose the right integration path.
Complete these steps before you invite partners or install tracking.
What you are setting up
- Program details — business info, approval settings, commission rules
- Tracking & integrations — click, signup, and sale tracking
- Share program — your partner-facing program link
1. Program details
Business details
| Field | Required | Notes |
|---|---|---|
| Company name | Yes | pre-filled from your account |
| Website URL | Yes | main product/site URL |
| Tagline | No | shown to partners |
| Logo | Yes | PNG, JPG, or SVG |
| Terms of Service URL | No | affiliate terms / program terms |
| Resources URL | No | partner-facing marketing resources |
Approval mode
| Mode | Description | Best for |
|---|---|---|
| Manual review | review each partner application | quality control, B2B motions |
| Auto-approve | approve applicants automatically | higher-volume programs |
Commission details
| Field | Description |
|---|---|
| Commission rate (%) | default partner commission |
| Commission duration | how long a referred customer keeps earning for the partner |
Common options: one-time, fixed-month recurring, or lifetime.
2. Tracking & Integrations
Set up tracking in three steps: clicks, signups, then payments.
Step 1 — Pageview / click tracking
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 { init } from '@affitor/sdk';
export function AffitorInit() {
useEffect(() => { init({ programId: YOUR_PROGRAM_ID }); }, []);
return null;
}
// render <AffitorInit /> once in app/layout.tsxScript tag:
<script
src="https://api.affitor.com/js/affitor-tracker.js"
data-affitor-program-id="YOUR_PROGRAM_ID"
data-affitor-debug="false">
</script>Step 2 — Signup / lead tracking
After signup succeeds, send your internal customer ID to Affitor.
Browser helper:
await window.affitor.signup('user_123', 'user@example.com');Server API:
{
"click_id": "cust_42_1234567890",
"customer_key": "user_123",
"email": "user@example.com"
}Step 3 — Sale / payment tracking
Choose the path that matches your checkout.
| Method | How it works | Best for |
|---|---|---|
| Server-side tracking | your backend sends POST /api/v1/track/sale after payment succeeds | any payment provider or custom backend |
| Stripe integration | you keep taking payment in your own Stripe checkout; Affitor attributes via metadata + webhooks | existing Stripe Checkout integrations |
For Stripe integration, use these public fields in metadata:
affitor_click_idaffitor_customer_keyprogram_id
For subscriptions, put the same values in both:
metadatasubscription_data.metadata
3. Share Your Program
Once setup is complete, share your partner recruitment link so affiliates can apply.
Recommended setup order
- Install click tracking first
- Wire signup tracking with a stable internal customer ID
- Choose Server-side tracking or Stripe integration for payment tracking
- Run test flows before launch