How to fix WooCommerce Subscriptions renewal failed

What this problem looks like

WooCommerce Subscriptions charges stored payment methods on a schedule. Renewal failure leaves subscriptions on-hold and may revoke member access depending on your settings.

Action Scheduler backlog, disabled WP-Cron, or expired cards cause more production incidents than Subscriptions plugin bugs.

Step 1: Read subscription and renewal order notes

Open the parent subscription in wp-admin. Notes list each renewal attempt with gateway responses. 'No payment method' means the token was removed. 'Card declined' is customer-side. HTTP errors point to integration or hosting blocks.

Step 2: Action Scheduler health

Failed, pending, or past-due actions mean cron is not processing. Install WP Crontrol or use hosting cron to call wp-cron.php every five minutes. Large queues after migration need WP-CLI from SSH.

Only run the commands below if you have SSH access to the server. They will not work inside File Manager.

bash

wp action-scheduler run --hooks=woocommerce_scheduled_subscription_payment
wp action-scheduler clean

Step 3: Gateway requirements for renewals

Stripe: Customer and payment method saved at signup, off-session charges enabled.
PayPal: Vault or reference transactions supported on your account.
Manual renewals: customer must return to pay if automatic billing is off.

Step 4: Retry rules and customer emails

WooCommerce Subscriptions can retry failed payments on a schedule. Configure retries under WooCommerce → Settings → Subscriptions. Ensure failed renewal emails are enabled so customers update cards before suspension.

Step 5: Plugin conflicts with membership and content access

Membership plugins listening to subscription status may revoke access on first failure even when retries are pending. Align grace periods across plugins. Exclude /my-account/ from aggressive caching on account and membership pages.

When to stop DIY and hire help

Subscription billing touches gateways, tax, EU regulations, and custom membership logic. BugShield fixes renewal pipelines and Action Scheduler backlogs at a confirmed price without hourly billing surprises.

Questions answered

WooCommerce Subscriptions renewal failed FAQs

Answers about payment tokens, scheduled actions, retries, gateway callbacks, manual renewals, and protecting customers from duplicate charges.

How do I manually process a failed renewal?

Open the subscription in wp-admin, use the Create pending renewal order action if available, or ask the customer to pay from their account payment methods page.

Why did all renewals fail at the same time?

Expired API keys, cron stopped site-wide, or gateway maintenance. Check Stripe or PayPal status pages and Action Scheduler pending count.

Does changing payment gateway break subscriptions?

Existing tokens do not migrate automatically. Plan customer outreach to re-enter cards when switching gateways.

Can low traffic cause missed renewals?

Yes, if WP-Cron depends on visits and no system cron exists. Low-traffic sites must use real server cron hitting wp-cron.php.

What causes a WooCommerce Subscriptions renewal to fail?

A declined payment method, missing token, gateway change, failed scheduled action, broken webhook, account restriction, or plugin conflict can stop renewal.

Where do I find the reason for a failed WooCommerce renewal?

Check the subscription and renewal-order notes, gateway logs, Action Scheduler, and matching provider event using the same amount, customer, and timestamp.

Can a missing payment token break automatic WooCommerce renewals?

Yes. Automatic renewal requires a reusable token linked to a supported gateway. Changing plugins or importing subscriptions can disconnect that token.

Can Action Scheduler stop WooCommerce subscription renewals?

Yes. Overdue or failed scheduled actions can prevent renewal orders from running. Fix the queue or cron problem before processing a large backlog.

Is it safe to retry a failed WooCommerce renewal manually?

First confirm the provider did not already collect payment. Then use the documented retry process and watch the order, token, webhook, and customer emails.

When should a developer investigate failed WooCommerce renewals?

Get help when failures affect many customers, tokens disappeared after a migration, scheduled actions are stuck, or retries risk duplicate charges.

Keep troubleshooting

Learn how to fix WooCommerce Subscriptions renewal failed.