Quick Start Guide

Before you begin, make sure you have the following ready:

• 1
  A Trackli account — Sign up at trytrackli.com/signup. No credit card required for the free tier.
• 2
  A Stripe account — Trackli integrates with Stripe to automatically track payments and calculate commissions. You will need your Stripe webhook secret.

After signing up, you will be guided through creating your first affiliate program.

1. Sign up and log in to your Trackli dashboard
2. Navigate to Settings and configure your program name
3. Set your default commission rate (e.g., 20% recurring)
4. Choose your commission type: one-time or recurring (recurring pays on every renewal)

# Example: Your program settings
Program Name:     My SaaS Affiliates
Commission Rate:  20%
Commission Type:  Recurring

Invite partners to join your affiliate program and share their unique referral links.

1. Go to the Affiliates tab in your dashboard
2. Click Add Affiliate and enter their name and email
3. Trackli generates a unique referral code for each affiliate
4. Share the referral link with your partner

# Each affiliate gets a unique referral link
https://yoursite.com?ref=partner123

# Affiliates can share this link on:
# - Their blog or website
# - Social media profiles
# - Email newsletters
# - YouTube video descriptions

Connect Trackli to your Stripe account so conversions are tracked automatically.

Add the Stripe webhook URL

1. Open your Stripe Webhook settings
2. Add a new endpoint with the URL provided in your Trackli dashboard
3. Select the events: checkout.session.completed and invoice.payment_succeeded

Configure your webhook secret

Copy the signing secret from Stripe and paste it into your Trackli Settings page under Stripe Webhook Secret.

# Your Stripe webhook endpoint (copy the exact URL from Trackli Settings > Stripe)
https://trytrackli.com/api/webhook/stripe/<your-account-id>

# Events to listen for:
# - checkout.session.completed
# - invoice.payment_succeeded

# After adding the endpoint, copy the signing secret:
# whsec_abc123...
# Paste it in Trackli Settings > Stripe Webhook Secret

If you need to record conversions manually (outside of Stripe webhooks), use the Trackli API.

Record a conversion via API

curl -X POST https://trytrackli.com/api/conversion \
  -H "Content-Type: application/json" \
  -H "X-API-Key: your_api_key_here" \
  -d '{
    "customerEmail": "customer@example.com",
    "affiliateRefCode": "partner123",
    "orderAmount": 4900,
    "currency": "usd"
  }'

Track an order

curl -X POST https://trytrackli.com/api/track/order \
  -H "Content-Type: application/json" \
  -H "X-API-Key: your_api_key_here" \
  -d '{
    "stripeEventId": "evt_1abc",
    "amountTotal": 4900,
    "customerEmail": "customer@example.com",
    "affiliateRefCode": "partner123",
    "currency": "usd"
  }'

Key terms used throughout the Trackli platform and documentation.

Referral

A visit to your site that originates from an affiliate's unique tracking link. Trackli records the click and attributes future activity to that affiliate.

Conversion

A completed purchase or sign-up made by a referred visitor. Conversions trigger commission calculations for the referring affiliate.

Commission

The earnings an affiliate receives for driving a conversion. Commissions are calculated as a percentage of the sale amount based on your program settings.

Affiliate

A partner who promotes your product using a unique referral link. Affiliates earn commissions on conversions they generate.

Payout

The transfer of earned commissions to an affiliate. Payouts are recorded in the Trackli dashboard and processed manually by the brand once commissions have been approved.

Now that your program is set up, explore the full API reference and documentation.