The auto-resume system ensures that paused subscriptions automatically return to active billing on the scheduled resume date without any customer or admin action required.
📌 What This Extension Adds: The auto-resume cron job, billing date adjustment logic, and resume notification email are all provided by Subscriptions Pro. Core DDLS has no concept of a paused state or auto-resume.
How Auto-Resume Works #
When a pause is initiated, the plugin:
- Records the pause in
wp_dmsilm_sp_pause_logwithpause_start,pause_end, andsubscription_id. - Schedules a single-run WordPress cron event (
dmsilm_sp_auto_resume_{subscription_id}) for the pause end date.
When the cron event fires:
- The subscription status is changed from
pausedtoactive. - The next renewal date is recalculated: the original next renewal date is shifted forward by the number of days paused.
- A resumption confirmation email (
pause-resumed.php) is sent to the customer. - The pause log record is updated with
resumed_attimestamp. - An order note is added to the subscription record.
Billing Date Adjustment #
The billing date shift is calculated precisely: if a subscription was due to renew on March 15 and was paused for 30 days starting March 1, the new renewal date is April 14 (March 15 + 30 days).
This ensures customers are not billed during the pause period and that their billing cycle resumes on the correct cadence.
What Happens if Cron Misses #
WordPress cron is triggered by site traffic. If the site has no visitors on the scheduled resume date, the event may fire late on the next page load. For mission-critical accuracy, consider using a server-level cron job (wp-cron via system cron) to ensure reliable execution.
Admin View #
The pending auto-resume date is visible in the Subscription Pro Status Metabox under the Paused state panel. Admins can also trigger an early resume from that metabox.
—
## Next Steps
- Payment Retries Overview — Understand how failed payment recovery works.
- Win-Back Campaigns Overview — Configure campaigns for customers who cancel instead of pausing.
- Customer Portal Overview — Full reference for the customer-facing portal interface.
