Table of Contents
Problem Description #
On checkout, payment methods list is empty (greyed out), or checkout feels stuck (spinner / infinite loading) when using the plugin.
Common Symptoms
- On checkout page, instead of payment method list, customer sees “no payment options available,” or blank area. WordPress.org
- Happens even though payment methods are enabled globally and plugin settings for categories/products seem correct.
Cause
- Conflict or mis‑configuration in the plugin settings (e.g. include/exclude mis settings) leading to all gateways being blocked.
- JavaScript or AJAX failure in checkout caused by plugin or by interference with other plugins or theme — preventing payment method list from rendering.
- Payment gateways might be disabled globally or some required gateway settings mis‑configured.
Solution (step-by-step)
- Check plugin settings: ensure that for the cart’s products, there is at least one gateway allowed (via include/exclude logic), not all gateways excluded.
- Disable other plugins and switch temporarily to a default theme to rule out JS or theme conflicts.
- Clear caching (browser, WP cache, server cache) and reload checkout page.
- Enable debugging: open browser console (F12), check for JS errors. Also enable WP_DEBUG to spot server-side PHP notices or errors.
- If using custom or third‑party payment gateways (not core WooCommerce), ensure they are compatible and properly enabled.
- If checkout still fails: consider enabling fallback gateway (if plugin supports) or simplify rules (e.g. only limit for certain product categories) to get checkout working.
Prerequisites
- Plugin and WooCommerce up-to-date. WPFactory+1
- Payment gateways properly configured and enabled in WooCommerce → Payments.
Additional Notes
- Let customers know about potential gateway restrictions when mixing products from different categories — helps manage expectations.
- Always test after changes to gateway/product rules.
