Troubleshooting Common Issues

Tracking Script Not Attributing

Check:

• Script loads from /track.js on your AffiliateBase app origin
• data-account-id is correct
• ?via=TOKEN appears in test URL
• /api/track returns success

Conversions Missing

Check:

• Checkout flow sets client_reference_id
• affiliatebase('convert', { email }) is called when required
• Stripe events are delivered and verified

Stripe Webhook Errors

Check:

• Correct webhook secret configured
• Signature header present
• Events are not being skipped for missing account context

Payout Run Failures

Check:

• Affiliate payout recipient status (for Stripe payouts)
• Provider attempt errors on the payout run
• Reconciliation actions for retry/poll/reset

Coupon Sync Issues

Check:

• Campaign has stripe_coupon_id
• Affiliate is active
• Stripe token is valid

When To Escalate

Escalate when any of these persist after one full retry cycle:

• Repeated webhook signature failures
• Repeated provider outage failures
• Systematic missing attribution across environments