Skip to main content
AffiliateBase
Features Pricing Compare Help
Log in Start for free

Troubleshoot Affiliate Tracking and Payout Issues

Diagnose AffiliateBase script loading, missing Stripe attribution, webhook failures, payout run errors, and coupon sync problems.

Table of Contents

This page is for AffiliateBase merchants. It lists the most common tracking, conversion, webhook, payout, and promo-code symptoms with the first things to check. Find your symptom, then check each item in order. For a full test path, use the linked guides at the end.

Tracking script not attributing

Check that:

  • The script loads from https://app.affiliatebase.io/track.js, or from /track.js when testing against a local app
  • data-account-id matches the account ID in the script snippet under Setup step 4 -> Add tracking -> View developer steps
  • The test URL includes ?via=TOKEN with a real affiliate token
  • The affiliate is pending or active, and the campaign isn’t archived
  • /api/track returns success

Conversions missing

Check that:

  • The Stripe Payment Link, Buy Button, or Pricing Table is on the same published page as the AffiliateBase script
  • Your backend-created Checkout Session receives referral_id from the browser, sets client_reference_id, and mirrors affiliatebase_referral_id metadata
  • You aren’t relying on browser identify for sales: it only records a lead. Purchase attribution requires a verified Stripe payment and referral handoff
  • Stripe events are delivered and verified

Stripe webhook errors

Check that:

  • The Stripe connection shows Connected — Live mode (or Connected — Test mode while testing) in Settings -> General -> Stripe Connection
  • The payment was made in the same mode (live or test) as your Stripe connection

For signature errors or missed events, contact support. AffiliateBase manages the webhook and its signing secret.

Payout run failures

Check:

  • The affiliate’s PayPal or Wise details are present
  • Export execution is complete in PayPal or Wise
  • Payouts -> Reconcile for payout runs with settlement or provider issues

Promo code issues

Check that:

  • For automatic codes, the campaign has a Stripe discount selected (Stripe discount applied to generated codes in setup)
  • For individually managed codes, the code is assigned under Affiliates -> select the affiliate -> Manage promo codes
  • The affiliate is active
  • Stripe is connected in the same mode (live or test) as the code

See Use Stripe Promo Codes with Affiliates for the full setup.

When to escalate

Contact support if any of these persist after one full retry cycle:

  • Stripe payments repeatedly not reaching AffiliateBase
  • Repeated provider outage failures
  • Systematic missing attribution across environments

Include your account ID, the affected Stripe event IDs or time window, and a description of the checkout path you use.

Detailed troubleshooting guides