WooCommerce 10.3.1 – 10.3.3: Dot Releases

What’s in this release

Add deprecated script warnings and backwards compatibility for third-party extensions #61599
Introduces an explicit L-1 support policy for script handles in frontend and admin asset classes, addressing compatibility issues where third-party plugins directly enqueue unprefixed script handles. Script handles like accounting, jquery-payment, and jquery-blockui now trigger deprecation warnings when used, while automatically loading their wc-prefixed equivalents to maintain functionality. This gives extension developers clear notice to update their code while preventing immediate breakage for stores using affected plugins.

Resolve critical race condition causing orders to be deleted from the database #61582
Resolves a critical bug where processing or completed orders could be incorrectly deleted during cart cleanup operations. The issue occurred when a customer’s session still contained a draft order ID after payment completion, causing the system to delete the processed order when the cart was emptied. This fix adds validation to ensure that draft orders are only removed later during cleanup operations, preventing potential data loss in high-traffic scenarios.

Fix PayPal order creation failures due to amount mismatches #61586
Addresses PayPal Standard order creation failures by including order fees with line items in the purchase unit breakdown. Without fees in the breakdown, the PayPal API would reject orders with an AMOUNT_MISMATCH error, stating that the total should equal the sum of item_total, tax_total, shipping, handling, insurance, minus discounts. This fix aligns with the legacy PayPal implementation and ensures accurate payment processing for orders that include fees.

Add payment method validation before PayPal payment capture #61564
Adds payment method validation before attempting PayPal payment capture operations. Without this check, the system would incorrectly attempt to capture PayPal payments for orders processed through other payment gateways like Stripe, resulting in failed capture attempts and misleading order notes. This fix ensures PayPal-specific operations only execute for actual PayPal orders, improving payment gateway compatibility.

Add session handler compatibility checks for cart operations #61561
Adds defensive validation to verify the get_session_data method exists before calling it on session objects in WC_Cart_Session. Not all classes extending WC_Session implement this method, which could cause fatal errors in edge cases like custom session handlers. This fix prevents internal server errors by checking the session object type before attempting to call non-universal methods.