Get started
How to Use Affitor
The end-to-end golden path: launch a program, install tracking, and run commissions through to payout.
This is the shortest path from zero to your first attributed commission. Each step links to the detailed guide, so use this page as your map and follow the links when you need depth.
The lifecycle at a glance
Phase 1 — Launch your program
Set up the program partners will join and get the API key your backend uses to report sales.
Phase 2 — Install tracking
Affitor attributes revenue from three signals across the customer journey. You install these once and they run continuously.
Follow the 3-Step Integration Guide to wire these up. Affitor can receive sales from connected Stripe Checkout sessions and paid invoices without a /api/v1/track/sale call from your backend. For sales outside those flows, report each sale server-side with your program API key. Here is that call:
curl -X POST https://api.affitor.com/api/v1/track/sale \
-H "Authorization: Bearer YOUR_PROGRAM_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"transaction_id": "txn_abc123",
"customer_key": "usr_9876",
"amount_cents": 4900,
"currency": "USD",
"sale_type": "payment"
}'The customer_key you send at signup must equal the one you send at sale. That single identifier is how Affitor links a sale back to the original click and credits the right partner.
- Open a partner link from your program. It carries the partner code in the Partner link parameter set on the Tracking settings page (
?via=by default for new programs; programs created before October 16, 2026 keep?aff=), and the tracker reads both?via=and?aff=. Anaffitor_click_idcookie is set
- Your signup fires
POST /api/v1/track/lead, returning 2xx. For sales outside the connected Stripe Checkout and invoice flows, your backend firesPOST /api/v1/track/sale, also returning 2xx
- The click, lead, and sale appear under your program's tracking events
- Send
additional_data: { test_mode: true }to create test events without generating commissions
Phase 3 — Commissions and payouts
Once a sale is attributed, Affitor creates the commission and moves it through your review and payout workflow.