Overview
Use this guide when a PayPress payment, subscription, donation, or fundraising button does not open Stripe Checkout.
Symptoms
- Clicking the button does nothing.
- The button stays disabled.
- The page shows a loading message but does not redirect.
- Stripe Checkout never opens.
- A donation form displays a refresh or unavailable message.
Likely Causes
- Stripe API keys are missing or saved for the wrong mode.
- The plan is inactive, unpublished, or misconfigured.
- The page is showing stale cached markup.
- JavaScript is blocked or failing on the page.
- A security plugin, firewall, or CDN is blocking PayPress requests.
- Donation or fundraising server validation is rejecting the current amount or campaign state.
Resolution Steps
- Confirm the plan is published and active.
- Confirm PayPress is using the correct Test or Live mode.
- Confirm the active-mode Stripe publishable and secret keys are saved.
- Open the page in a private browser window and try again.
- Clear page cache and CDN cache if the page was recently changed.
- If this is a donation or fundraising page, confirm the campaign is open and the amount is valid.
- Check the browser console for visible JavaScript errors.
- Check PayPress Diagnostics and Event Timeline for related errors.
- Try a simple test plan on a basic WordPress page to rule out page builder conflicts.
Expected Result
The payment button should start the PayPress launcher flow and redirect the customer to Stripe Checkout.
Additional Notes
Public marketing pages can remain cacheable, but launcher endpoints and donation fallback routes should not be cached. If a button breaks only for logged-out visitors, caching is a strong suspect.