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.

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

Launch a program

You define commissions, approval rules, and payout settings.

Partners promote

Approved partners share links that identify their traffic.

Track referrals

Clicks, signups, and sales are captured and attributed.

Commission created

Attributed revenue creates a commission automatically.

Payout

Review, hold, 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.

1. Create your account

Set up your advertiser account and open the dashboard.

2. Set up your program

Define program basics, branding, and what partners see.

3. Define commissions

Choose how partners earn — signups, sales, or subscription payments.

4. Create an API key

Generate the program API key your server uses to authenticate tracking calls.

Phase 2 — Install tracking

Affitor attributes revenue from three signals across the customer journey. You install these once and they run continuously.

Click

The tracker records first touch and sets the click cookie.

Signup / lead

Your signup flow ties a customer to the referring click.

Sale

Your backend reports revenue so a commission can be created.

Follow the 3-Step Integration Guide to wire these up. Sales are always reported server-side with your program API key — here is the canonical 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

Visit your site with `?aff=TESTCODE` — an `affitor_click_id` cookie is set

Network

Your signup fires `POST /api/v1/track/lead` and your backend fires `POST /api/v1/track/sale`, both 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.

Review performance

Monitor clicks, leads, sales, and per-partner performance once you are live.

Validate commissions

Understand how commissions are reviewed, held, and cleared.

Run payouts

Move cleared commissions through to partner payout.

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 →

The lifecycle at a glance

Phase 1 — Launch your program

Phase 2 — Install tracking

Phase 3 — Commissions and payouts

Your golden-path checklist

On this page