Payment Gateway Not Working Correctly

If your payment gateway is not displaying or functioning properly with Donation Platform for WooCommerce, you’re not alone. This is a known compatibility issue that affects some gateways when used with specific donation form styles.

Some payment gateways are not fully compatible with the one-page donation form layouts provided by Donation Platform for WooCommerce.

Incompatible Styles

Styles 1, 2, 3, and 5 use dynamic, JavaScript-based updates to add the donation to the cart. Unfortunately, not all payment gateways support this dynamic cart update.

Recommended Fix

We recommend switching to Style 4, which is the most compatible with a wide range of payment gateways.

How to Switch to Style 4:

Donation form styles are controlled via a shortcode parameter.

  • If you’re using the shortcode, make sure it includes style="4"
  • If you’re using the Gutenberg Block, you can select the style from the block settings in the right sidebar under “Donation Form Style”. Simply choose “Style 4 (just first step)” from the dropdown.

Additional Troubleshooting

  • Test in a Private Window
    Open your site in a private/incognito browser window to ensure no cached sessions or cookies are interfering with the donation process.
  • Verify Payment Gateway Configuration
    Double-check the settings for your specific payment gateway (e.g. Stripe, PayPal, etc.) to make sure they are correctly configured and active in WooCommerce.

Why Is This Happening?

When a one-page donation form is loaded, the WooCommerce cart starts off empty. Once a donor selects an amount, the cart is dynamically updated via JavaScript without reloading the page.

Some payment gateways expect the cart and session to be ready at the time the page loads. They may not support these dynamic updates without a full page reload — resulting in missing buttons, errors, or broken checkout experiences.

If you’re still having trouble, feel free to contact our support team with details about your setup.