Troubleshooting
Fix common issues with referral tracking, commission calculation, payout gateway errors, and email notifications in Royal Affiliate Pro.
Troubleshooting
Referral not tracking
- Check the cookie is being set (browser dev tools > Application > Cookies > look for
rafp_ref) - Verify the affiliate is approved (pending affiliates do not track referrals)
- Check if the page is in the Excluded Pages list
- Clear your caching plugin cache
- Verify WooCommerce is active (required for WooCommerce-based referrals)
Payouts not processing
- Verify API keys are correct (Stripe Secret Key / PayPal API credentials)
- Check the affiliate has connected their payment account in their dashboard
- Ensure the affiliate has met the minimum payout threshold
- Check that automated payouts are enabled (Settings > Payments)
Affiliate dashboard not showing
- Verify the
[rafp_dashboard]shortcode is on the page - Check the user is logged in AND registered as an affiliate
- Verify the affiliate is approved (not pending or rejected)
Commission amount seems wrong
- Review the 7-level priority chain - a higher-priority rate may be overriding
- Check product-specific and category-specific rates
- Verify the affiliate's tier rate
- Check if a campaign rate is currently active
Stripe Connect errors
- Verify Client ID, Secret Key, and Publishable Key are all entered
- Ensure the webhook endpoint is configured in your Stripe dashboard
- Check Stripe is in the correct mode (Sandbox vs Live)
Still stuck? Email priority support
Email support@royalplugins.com with your site URL, Royal Affiliate Pro version, the affiliate-program area where the issue appears (registration, dashboard, payouts, Stripe Connect, etc.), and a description of what you tried. Priority email support is included with your Royal Affiliate Pro license — typical response time is within 24 hours.