Skip to Content

Get started

How to Use Affitor

The end-to-end golden path: launch a program, install tracking, and run commissions through to payout.

View as Markdown

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.

Who this is for
New advertisers setting up Affitor for the first time
Time required
~30 minutes of setup, then tracking runs on its own
Prerequisites
Your product live, a signup flow, and a payment provider
Outcome
A live program that attributes clicks, signups, and sales to partners and moves commissions to payout

The lifecycle at a glance

1
Launch a program
You define commissions, the hold period, and payout settings.
2
Partners promote
Approved partners share links that identify their traffic.
3
Track referrals
Clicks, signups, and sales are captured and attributed.
4
Commission created
Attributed revenue creates a commission automatically.
5
Payout
Hold, approve, and pay out — all in one place.

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.

1
Click
The tracker records first touch and sets the click cookie.
2
Signup / lead
Your signup flow ties a customer to the referring click.
3
Sale
Your connected Stripe account or your backend reports revenue so a commission can be created.

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"
}'
One customer key end to end

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.

Verify success
Browser
  • 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=. An affitor_click_id cookie is set
Network
  • Your signup fires POST /api/v1/track/lead, returning 2xx. For sales outside the connected Stripe Checkout and invoice flows, your backend fires POST /api/v1/track/sale, also returning 2xx
Dashboard
  • The click, lead, and sale appear under your program's tracking events
If it doesn't work
  • 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.

Your golden-path checklist

Next recommended step
Open the advertiser quickstart

Ready to configure everything in detail? Start with account creation and program setup.

Open advertiser quickstart →

On this page

Share feedback

Tell us what is missing or unclear on “How to Use Affitor”.