A customer begins the checkout process, selects an item, and redirects to an external payment processor. However, they change their mind at the last second and close the window, causing the transaction to time out. In the WooCommerce backend, the order status transitions properly from "Pending Payment" to "Cancelled." However, a critical bug leaves the product inventory count locked.

The system fails to restore the reserved item back to the main inventory pool. If this happens to low-stock items during a promotion, products will appear as "Out of Stock" on the frontend, even though no one actually purchased them. This ghost reservation bug occurs when background scheduling scripts fail to trigger. WooCommerce uses a tool called Action Scheduler to release stock holds. If your site’s WP-Cron engine is unstable or blocked by server-level firewalls, the trigger event is missed entirely, keeping inventory locked forever.

The Solution

Resolving stuck stock reservations requires stabilizing your background task scheduler and automating inventory pullbacks.

  1. Set Up a Real Server Cron Job: Relying on default WordPress page-visit triggers to run schedules is highly unreliable. Disable default WP-Cron by adding this to wp-config.php:

    PHP
     
    define('DISABLE_WP_CRON', true);

  2. Configure System Cron Panel: Log into your hosting dashboard (cPanel/Plesk), navigate to Cron Jobs, and create a new task to run every 5 minutes using this command line:

    Plaintext
     
    wget -q -O - https://yourstore.com/wp-cron.php?doing_wp_cron >/dev/null 2>&1

  3. Force Immediate Inventory Release: Add this programmatic fallback to force WooCommerce to instantly return stock units to available status the exact moment an order transitions to cancelled:

PHP
 
add_action('woocommerce_order_status_cancelled', 'immediate_stock_restoration_fallback', 10, 1);
function immediate_stock_restoration_fallback($order_id) {
    $order = wc_get_order($order_id);
    if ($order && 'yes' === get_option('woocommerce_manage_stock')) {
        wc_maybe_increase_stock_levels($order);
    }
}