WP Simple Pay Blog

Stripe Tutorials, Tips, and Resources for WordPress to Accept Payments

Introducing WP Simple Pay 4.17.6: Never Miss a Failed Payment Again

Last updated on

Written By: author avatar Prappo Prince

A customer fills out your payment form, enters their card, and clicks pay. The card is declined. Or a subscriber’s monthly renewal fails because their card expired last week. Until now, you only found out if you went looking in Stripe, and your customer often didn’t find out at all.

That silence costs you money. With WP Simple Pay 4.17.6, you and your customers hear about failed payments right away, so a declined card turns into a second try instead of a lost sale.

Know the Moment a Payment Fails

WP Simple Pay already emails you and your customers when a payment succeeds, is processing, or is refunded. This release adds two new emails for when a payment doesn’t go through.

  • Payment Failure Notification goes to you, the site owner. It’s turned on automatically, so you start hearing about failed payments as soon as you update.
  • Payment Failure Confirmation goes to your customer. It lets them know the payment could not be processed, explains why, and asks them to check their details and try again. This one is off until you turn it on, so you decide whether customers receive it.
The email selector in WP Simple Pay email settings, dropdown open, showing Payment Failure Notification and Payment Failure Confirmation

Both emails work for one-time payments and for subscription renewals. That second part matters: a failed renewal is one of the easiest ways to lose a subscriber without either of you noticing. Now you get the heads-up while there’s still time to reach out.

Tell Customers Exactly What Went Wrong

“Your payment failed” on its own isn’t very helpful. Two new smart tags fill in the details:

  • {failure-reason} shows a plain-language explanation, such as “Your card was declined.”
  • {failure-code} shows the short code for the failure, handy for your own records.

Like every other WP Simple Pay email, you can edit the subject line and message to match your voice. Internal notes meant only for you are never shown in the customer’s email.

A sample Payment Failure Confirmation email in an inbox, showing the subject 'Your payment could not be processed' and the reason 'Your card was declined.'

Set It Up in a Minute

  1. Go to WP Simple Pay → Settings → Emails.
  2. Choose Payment Failure Notification or Payment Failure Confirmation from the list and click Configure.
  3. Turn the email on, adjust the subject and message if you like, and save.
The Payment Failure Notification email settings with the enable toggle, subject line, and message editor

There’s also built-in protection against floods of failed payments. Each email is limited to 10 per form per hour, so if someone runs a batch of stolen cards through your form, your inbox stays usable and your site isn’t used to email strangers.

Fewer surprises in your Stripe account, and more customers who get the chance to finish their purchase. Learn more about every email WP Simple Pay sends in our email types reference.

Give Customers More Ways to Pay Over Time

Two new buy now, pay later options let customers spread out larger purchases:

  • Zip for customers in Australia and the United States.
  • Alma for customers in France, Belgium, Spain, Italy, Luxembourg, and the Netherlands, who can pay in 2, 3, or 4 installments.

Turn them on in the form editor under Payment → Payment Methods. They work on both on-site and Stripe Checkout forms for one-time payments.

Every buy now, pay later provider has a minimum and maximum order size, so the form builder now shows each method’s accepted range right under its name. Zip, Alma, and Afterpay/Clearpay all show theirs, so you can tell at a glance which ones fit your prices. On your form, they only appear when the total qualifies.

The Payment Methods list in the form builder with Zip and Alma enabled and their accepted payment amount ranges shown below each method

Get started with our guides to accepting Zip payments and accepting Alma payments, or see every payment method WP Simple Pay supports.

Reassure Customers Right at the Pay Button

The moment before someone clicks pay is when doubt creeps in. Is this site safe? Where is my card going?

Every payment form now shows a small “Secure payment via Stripe” line with a lock icon right below the submit button. It appears on embedded, overlay, and Stripe Checkout forms, with nothing to set up.

An on-site payment form with the 'Secure payment via Stripe' line and lock icon centered below the payment button

Prefer a cleaner look on a particular form? Go to the form’s General tab, find Form Display Options, and choose Hide trust badge.

Let Stripe Pick the Best Payment Methods

Picking payment methods for every form takes guesswork, especially when your customers come from all over the world. A new Optimized Checkout setting lets Stripe decide which payment methods to show on your Stripe Checkout forms, and in what order, based on each customer’s location, device, and what they’re most likely to use.

You’ll find it under WP Simple Pay → Settings → Stripe → Account. It’s off by default, so your forms keep the methods you’ve chosen until you turn it on. Just make sure the payment methods you want are also turned on in your Stripe Dashboard. See our Stripe Checkout display options guide for more.

The Optimized Checkout setting in the Stripe Account settings, labeled 'Let Stripe automatically select and order payment methods'

A CAPTCHA That Matches Your Site

If you use Cloudflare Turnstile to block spam, you can now choose how it looks. Pick a Theme (Auto, Light, or Dark) so it blends into dark-themed sites, and a Size (Normal, Flexible, or Compact) so it fits narrow sidebars or stretches across a full-width form.

Both settings live under WP Simple Pay → Settings → General → CAPTCHA. Your existing forms look exactly the same until you change them. More in our anti-spam reference.

A payment form on a dark-themed site with the Cloudflare Turnstile widget using the Dark theme

More Improvements in This Release

  • One-click checkout with Link. When Link is turned on in your Email field, returning Link customers can now check out with their saved details on on-site card forms.
  • Cleaner admin notification emails without the WP Simple Pay logo at the top, so they look like your store’s own emails.
  • Forms keep loading with optimization plugins that remove or delay scripts, so you’ll see fewer “payment form could not be loaded” messages.
  • Payments are recorded again on sites where an earlier database update didn’t finish.
  • Unchecking the fee recovery checkbox now works. Customers who uncheck a Fee Recovery Toggle that starts checked are no longer charged the fee.
  • No more “Invalid CAPTCHA” on Manage Subscriptions pages that use reCAPTCHA v3.
  • Smoother settings screens when opened from the WP Simple Pay menu, with the email Configure button working and the Save Changes button no longer covered.
  • Safer form duplication, with extra checks that you’re allowed to edit the form you’re copying.

For the full list of changes, see the changelog.

Start Catching Every Payment Today

This release makes sure no failed payment slips by unnoticed, gives your customers more ways to pay, and adds a little extra reassurance right where they decide to buy.

Update from your WordPress dashboard under Plugins to get everything above. If you have any questions, our support team is happy to help.

We’d love to hear what you’d like to see next. Let us know in the comments or reach out anytime.

Disclosure: Our content is reader-supported. This means if you click on some of our links, then we may earn a commission. We only recommend products that we believe will add value to our readers.

Leave a Reply

Your email address will not be published. Required fields are marked *

This site uses Akismet to reduce spam. Learn how your comment data is processed.

Start Accepting Payments Today

Start accepting one-time and recurring payments or donations on your WordPress website.