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
  • Check the API key has not expired: Lemon Squeezy keys carry an expiry date (Settings → API)
  • 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
  • Live payments only: make sure the webhook was registered with the live API key (test and live webhooks are separate)

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
  • Click “Register Webhook on Lemon Squeezy” again: from version 2.4.1 it updates the existing webhook, sends the current secret and removes extra copies (two webhooks for one site send every event twice)

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
  • On a block theme, update to 2.3.0 or later: older versions never opened the overlay there
  • 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
  • Update to 2.4.0 or later: older versions sent refunds to an address Lemon Squeezy does not have
  • Ensure order has Lemon Squeezy order ID
  • Check debug logs for error details
  • Try refund in Lemon Squeezy dashboard directly

Lemon Squeezy Not Offered for a Subscription

Problem: Lemon Squeezy does not show at checkout for a WooCommerce Subscriptions product

Solutions:

  • Open the product’s edit screen: it says whether the product is ready for Lemon Squeezy, or why not
  • Link the product (or each variation) to a Lemon Squeezy subscription variant on the same schedule
  • Remove a sign-up fee, free trial or fixed renewal day; Lemon Squeezy charges the same amount every time
  • Keep one subscription per order, without one-time products in the same cart

Empty Space Instead of the Product Image

Problem: The Lemon Squeezy checkout shows a blank area where the image should be

Solutions:

  • Lemon Squeezy’s checkout only shows images kept on Lemon Squeezy’s servers
  • Under “Image for Several Products”, pick your store logo or a product image from Lemon Squeezy, then click “Refresh from Lemon Squeezy”
  • If you use the wcls_checkout_media filter, send only Lemon Squeezy image addresses

Reminder Email Button Shows an Error

Problem: The “Take me to my order” button in Lemon Squeezy’s reminder email opens an error page

Solutions:

  • Update the plugin to 2.3.1 or later: payment links now stay open for 7 days
  • If you shortened the link time with wcls_checkout_expiry_seconds, make it longer than your reminder schedule

Orders Stay Unpaid After Moving From the Free Version

Problem: Payments arrive at Lemon Squeezy, but orders made before Pro stay pending

Solutions:

  • Update Pro to 2.2.0 or later, which answers the free version’s webhook address and marks those orders paid
  • Keep the webhook in Lemon Squeezy as it was; Pro uses the same secret

Still Need Help?

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

Was this page helpful?

Still stuck? Ask us

Related articles

Features Processing Refunds Reference Developer Hooks Features License Key Delivery