Troubleshooting
The issues that actually come up — license errors, tracking not recording, held referrals, payout test failures — and their fixes.
License & updates
"This license is already active on the maximum number of sites." Free a slot: deactivate a site you no longer use from that site's Affiliates → License screen, or remotely from your account page — then activate again. Or upgrade to a bigger plan via support.
"Could not reach the license server." Your host is blocking outgoing HTTP requests. Ask them to allow connections to affiliatefactorywp.com, then click Re-check on the License screen.
An update shows but won't install. The update row says why — almost always an expired license. Renew, click Re-check, and it installs normally.
Tracking
Test referral not recording. Work through these in order: (1) use a private browser window for the test — your admin session can be excluded from tracking; (2) check a caching/optimization plugin or CDN isn't stripping query strings or cookies — referral links need their parameter to survive; (3) if you gate tracking behind consent, accept the consent prompt in your test; (4) confirm the referral window hasn't been set to something tiny under Settings → Tracking. The full mechanics are in referral tracking.
Referral recorded but held. That's fraud review doing its job — open it, read the reason, approve or reject. Self-test purchases from your own IP are a classic legitimate hold.
Payouts
Test connection fails. The card's result message says what the API rejected — typically wrong-mode credentials (live vs. sandbox) or missing API permissions on the PayPal/Stripe side. Fix the credential, test again; every test lands in the activity log.
Forms & portal
Application form or portal shows nothing. Confirm the page contains the right shortcode — [affiliate_factory_registration] or [affiliate_factory_portal] — and check the Pages & shortcodes panel on the Dashboard, which reports what's detected where.
When to open a ticket
If ten minutes here hasn't fixed it, open a support ticket with three things: your license key, your site URL, and what you did / what you expected / what happened. Technical issues resolve fastest when we can see the WordPress and plugin versions too — they're on the License screen.