Table of Contents
Problem Description #
When a user adds to cart products belonging to different categories/tags (each with different payment gateway rules), the payment gateway filter fails, often no payment method available, or checkout fails.
Common Symptoms
- Cart with mixed products, checkout page shows no payment methods (greyed out) or “No payment options available.” WordPress.org+1
- User gets stuck; cannot select valid payment method; order cannot complete.
Cause
- The plugin’s logic cannot resolve conflicting gateway rules across multiple products: i.e. when one product allows Gateway A and another allows Gateway B, there may be no common gateway to satisfy both rules. This conflict leads to no gateway being presented. As described in “Mixed payment gateway issue” forum thread. WordPress.org
- No fallback gateway configured to handle mixed-cart situations.
Solution (step-by-step)
- Decide on a fallback gateway rule when cart contains mixed products, a gateway that works for all or is most appropriate (e.g. bank transfer).
- In plugin settings, enable or set a “fallback payment method” (if plugin supports fallback) for mixed cart scenarios.
- Alternatively: revise product-category payment rules to ensure there is at least one overlapping gateway across all possible product combinations in cart.
- Test by adding products from different categories, ensure fallback gateway appears or at least one valid gateway remains.
- Communicate to customers (e.g. via notice) if mixed-product carts may lead to limited payment options, to avoid frustration.
Prerequisites
- Use of Pro version if fallback or advanced rules are needed (fallback often part of advanced features) WordPress.com+1
- Clear understanding of which products/categories use which gateways.
Additional Notes
- For stores with many categories, use a matrix or spreadsheet to map categories → allowed gateways to avoid conflicts.
If you sell mixed-item orders often, consider simplifying rules to avoid dead‑end carts.
