# Troubleshooting

> Fix common issues with referral tracking, commission calculation, payout gateway errors, and email notifications in Royal Affiliate Pro.

- Canonical: <https://royalplugins.com/support/royal-affiliate/troubleshooting/>
- Last updated: 2026-09-04
- HTML version: <https://royalplugins.com/support/royal-affiliate/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](#commission-priority) - 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](mailto: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.

[← Previous: Settings](https://royalplugins.com/support/royal-affiliate/settings/)
[Next: FAQ →](https://royalplugins.com/support/royal-affiliate/faq/)