Browse Plugins

Troubleshooting

All Lemon Squeezy for WordPress docs Get Lemon Squeezy for WordPress

Connection Test Failed

Problem: Connection test returns an error

Solutions:

  • Verify API Key copied correctly (no spaces)
  • Check Store ID is correct
  • Ensure SSL certificate is valid
  • Check server can make HTTPS requests
  • Try regenerating API key in Lemon Squeezy

Payment Not Processing

Problem: Order stays pending after checkout

Solutions:

  • Check product has Variant ID mapped
  • Enable debug logging and check logs
  • Verify webhook configured correctly
  • Check webhook secret matches
  • Ensure webhook URL accessible

Webhooks Not Working

Problem: Orders not updating automatically

Solutions:

  • Test webhook from Lemon Squeezy dashboard
  • Verify webhook secret matches
  • Check SSL certificate valid
  • Ensure REST API not blocked by security plugins
  • Temporarily disable security plugins to test
  • Review webhook delivery logs in Lemon Squeezy
  • Try re-registering webhook using the auto-register button

Overlay Checkout Not Opening

Problem: Popup doesn’t appear in overlay mode

Solutions:

  • Check browser console for JavaScript errors
  • Verify no ad-blocker is blocking lemonsqueezy.com scripts
  • Try a different browser to rule out extensions
  • Check for theme or plugin JavaScript conflicts
  • Switch to redirect mode as a fallback
  • The plugin shows a fallback link if the overlay can’t open

License Key Not Appearing

Problem: License key not showing on order

Solutions:

  • Verify license_key_created webhook event is enabled
  • Check that the product in Lemon Squeezy has license key generation turned on
  • Look at debug logs for the license key webhook event
  • Ensure the WooCommerce order ID is being passed correctly to LS

Product Not Found

Problem: Error about product not found

Solutions:

  • Edit product in WooCommerce
  • Check the Lemon Squeezy Variant ID field has a value
  • Verify variant exists in Lemon Squeezy and is not archived
  • Try using the “Sync Products” feature to refresh
  • For variable products, check each variation has its own Variant ID

Refund Failed

Problem: Cannot process refund

Solutions:

  • Verify payment was through Lemon Squeezy
  • Check API key has refund permissions
  • Ensure order has Lemon Squeezy order ID
  • Check debug logs for error details
  • Try refund in Lemon Squeezy dashboard directly

Still Need Help?

Enable debug logging, reproduce the issue, and check logs at WooCommerce → Status → Logs. Then contact support with log excerpts.