Playbook de Actualización WooCommerce — Evita Desastres de Checkout

Por qué las actualizaciones WooCommerce son peligrosas

WooCommerce 7.x y 8.x introdujeron cambios arquitectónicos mayores — HPOS (High-Performance Order Storage), Cart/Checkout basado en Bloques, REST API v4. Cada uno es bueno en aislamiento; juntos con cientos de plugins terceros crean un campo minado de compatibilidad.

Un checkout que funcionaba ayer puede romperse hoy tras una actualización rutinaria. La rotura es a menudo silenciosa — los clientes ven una página de error genérica, abandonan el carrito, y nunca te enteras.

Este playbook es el procedimiento que corremos antes de cada actualización WooCommerce. Atrapa el 95% de problemas de compatibilidad antes de que golpeen producción.

El checklist pre-vuelo (antes de cualquier actualización)

Backup

cd /var/www/yoursite
wp db export pre-woo-update-$(date +%Y%m%d).sql
tar -czf wp-content-pre-woo-$(date +%Y%m%d).tar.gz wp-content/

Si algo va mal, restauras en 10 minutos.

Matriz de compatibilidad

Revisa la compatibilidad oficial de WooCommerce:

wp plugin status woocommerce

Anota tu versión actual. Visita https://woocommerce.com/document/release-notes/ para ver qué cambió en la versión objetivo.

Para cada extensión WooCommerce instalada, revisa su compatibilidad de versión WooCommerce en su página de producto o en el admin del plugin.

Extensiones críticas a verificar (siempre revisamos estas)

Subscriptions
Memberships
Pasarelas de pago (Stripe, PayPal, Square)
Plugins de shipping (Table Rate, Advanced Shipping)
Plugins de tax (TaxJar, Avalara)
Integraciones print-on-demand (Printful, Printify)
Email marketing (Klaviyo, MailerLite for WC)

Si alguno no muestra "Compatible with WC X.Y.Z" (la versión objetivo), espera a que se actualicen.

Clon staging

# Clona producción a staging
wp db export /tmp/clone.sql
ssh staging.yoursite.com "wp db import /tmp/clone.sql"
rsync -a /var/www/yoursite/wp-content/ staging:/var/www/staging/wp-content/

Actualiza en staging primero. Prueba el flujo completo de compra.

La prueba completa de checkout (corre en staging)

Prueba cada método de pago, cada método de shipping, cada tipo de producto:

Test 1 — Producto estándar, tarjeta de crédito

Añade al carrito
Procede al checkout
Llena billing/shipping
Elige opción de shipping
Paga con tarjeta de prueba (Stripe: 4242 4242 4242 4242)
Verifica página de confirmación de orden
Verifica orden en WooCommerce → Orders
Verifica email de confirmación recibido

Test 2 — Producto variable, múltiples en carrito

Mismo flujo, pero con un producto variable (variaciones de talla/color) y 3+ items en carrito. Atrapa bugs relacionados con variaciones.

Test 3 — Producto de suscripción (si vendes suscripciones)

Suscripciones involucran los mayores puntos de integración de plugins. Siempre prueba: - Primer pago - Cancelación del cliente desde Mi Cuenta - Acción admin de renovación - Email de renovación fallida

Test 4 — Cupón en checkout

Aplica un cupón. Verifica que el descuento aplica. Verifica que el total de orden actualiza. Verifica que el conteo de uso del cupón incrementa.

Test 5 — Creación de cuenta de cliente

Checkout como guest, creando una cuenta. Inicia sesión inmediatamente después. Verifica que las órdenes muestran en la cuenta.

Test 6 — Checkout móvil

Repite tests 1-2 en un dispositivo móvil real (no solo modo móvil de DevTools). El checkout móvil se rompe diferente al desktop.

Roturas comunes en actualizaciones WooCommerce 2026

Migración HPOS

WooCommerce 8.x introdujo High-Performance Order Storage. Las órdenes se mueven de wp_posts a nuevas tablas (wp_wc_orders, wp_wc_order_addresses, wp_wc_order_stats).

Si tienes extensiones que leen órdenes vía WP_Query o get_post_meta() directamente, se rompen.

Mitigación: en WooCommerce → Advanced → Features, puedes deshabilitar HPOS mientras migras. Pero deshabilitar por siempre no es una opción — futuras versiones lo requerirán.

Para cada extensión, revisa sus docs por "HPOS compatible" o "Custom Order Tables support."

Bloques Cart/Checkout (en lugar de shortcode)

WooCommerce 8+ por defecto usa Cart y Checkout basados en Bloques en lugar de las páginas viejas basadas en shortcode. Muchos plugins viejos (especialmente plugins custom de campos de checkout) solo funcionan con modo shortcode.

Si tu checkout existente tiene campos custom o layouts vía un plugin que no soporta Bloques, la actualización los rompe.

Mitigación: revierte a modo shortcode en WooCommerce → Settings → Advanced → Page setup. Configura página Cart para usar shortcode [woocommerce_cart] y página Checkout [woocommerce_checkout].

Esto es un workaround temporal. Planea migración a Bloques en 6-12 meses.

Cambios de API en pasarela de pago

Stripe ocasionalmente rota versiones SDK PHP requeridas. Si tu plugin de pasarela Stripe necesita Stripe PHP SDK 12+ y tu hosting aún envía 10, los pagos se rompen.

Mitigación: revisa los "System Requirements" del plugin de pasarela antes de la actualización WooCommerce. Asegura versión PHP compatible.

Migraciones de base de datos en primera petición

Tras una actualización WooCommerce, la primera petición de front-end corre migraciones de base de datos. Con tiendas grandes (50,000+ órdenes), esto puede expirar. Los visitantes ven errores 500/504.

Mitigación: corre migración vía WP-CLI en staging primero para medir tiempo:

wp wc update --confirm

Si toma más de 30 segundos, programa la actualización de producción para una ventana fuera de horas y dispara la migración vía WP-CLI inmediatamente después.

El procedimiento de despliegue

Tras que las pruebas staging pasen:

# Backup de nuevo justo antes
wp db export final-backup-$(date +%Y%m%d-%H%M).sql

# Pon sitio en modo mantenimiento
wp maintenance-mode activate

# Actualiza WooCommerce
wp plugin update woocommerce

# Corre cualquier migración pendiente
wp wc update --confirm

# Actualiza otros plugins (uno a la vez)
wp plugin update woocommerce-subscriptions
wp plugin update woocommerce-stripe-gateway
# etc.

# Verifica
wp wc system-status

# Prueba checkout inmediatamente
curl -I https://yoursite.com/checkout/

# Sal de modo mantenimiento
wp maintenance-mode deactivate

Downtime total: 2-5 minutos para tienda típica.

Verificación post-actualización

Dentro de 30 minutos del despliegue:

# Revisa log de error
tail -100 /var/www/yoursite/wp-content/debug.log

# Revisa estado WooCommerce
wp wc system-status | grep -i "error\|warning"

# Coloca orden de prueba usando método de pago real
# (usa un producto de bajo valor para que el refund sea rápido si lo mantienes)

Si algo está roto, haz rollback inmediatamente:

# Restaura plugins
tar -xzf wp-content-pre-woo-$(date +%Y%m%d).tar.gz

# Restaura base de datos
wp db import pre-woo-update-$(date +%Y%m%d).sql

Rollback completo: 5-10 minutos.

Errores comunes durante actualizaciones WooCommerce

Actualizar durante horas de negocio — incluso actualizaciones exitosas tienen breve downtime
Sin prueba staging — producción se vuelve el banco de prueba
Actualizar todos los plugins de una vez — si algo se rompe, no puedes saber qué plugin
No probar el checkout real — escaneo visual no es suficiente; completa una compra de prueba

Cuándo llamar a un especialista

Las actualizaciones WooCommerce pueden ser de alto riesgo para ingresos. Hacemos actualizaciones programadas y monitoreadas para tiendas activas incluyendo el ciclo completo staging/producción con monitoreo post-actualización.

Reparación WooCommerce para checkout roto. Para trabajo más amplio de plugins ve reparación de conflictos de plugin.