Nota de ingeniería

El checkout de WooCommerce no funciona: una ruta práctica de diagnóstico

Diagnosticar fallos de checkout entre JavaScript, pagos, validación, caché e integraciones.

Los fallos de checkout afectan transacciones reales. Conserva logs y datos de pedidos antes de cambiar varios plugins o capas de caché.

Si una prueba puede generar cargos reales o pedidos duplicados, usa un método de pago seguro o staging.

1. Reproducir el fallo exacto

Anota carrito, estado del cliente, método de pago, acción del navegador y error visible. Un flujo reproducible vale más que “el checkout no funciona”.

2. Separar front-end y servidor

Errores JavaScript, peticiones bloqueadas y validaciones son distintos de errores PHP o respuestas de la pasarela. Revisa red del navegador y logs del servidor.

3. Revisar pagos y webhooks

El formulario puede enviarse bien mientras falla la confirmación de pago o el webhook posterior. Comprueba logs de la pasarela y transiciones de estado.

4. Revisar exclusiones de caché y optimización

Carrito, checkout y cuenta no deben cachearse como páginas normales. El retraso o minificación de scripts también puede romper componentes de pago.

5. Aislar extensiones de forma controlada

En staging, prueba una frontera sospechosa cada vez. Envíos, impuestos, suscripciones y antifraude pueden alterar el checkout.

6. Verificar toda la transacción tras el arreglo

Comprueba pago, creación de pedido, correos, stock, webhooks y cualquier integración externa de fulfillment o CRM.