Pocos problemas generan tanta frustración —y pérdidas económicas directas— como una pasarela de pago que deja de funcionar. Cada minuto que tu tienda no puede procesar pagos es un cliente que abandona el carrito y, probablemente, no vuelve.
Los errores en las pasarelas de pago de WooCommerce pueden deberse a configuraciones incorrectas, conflictos con plugins, certificados SSL caducados o cambios en las API de los proveedores. En esta guía cubrimos las causas más comunes y cómo resolverlas sin necesidad de conocimientos avanzados.
Errores más frecuentes en pasarelas de pago
Antes de tocar ninguna configuración, identifica el síntoma exacto. WooCommerce suele mostrar mensajes genéricos como «Ha habido un error al procesar tu pago» que ocultan la causa real. Revisa el log de WooCommerce en WooCommerce → Estado → Registros y filtra por la pasarela afectada.
Los errores más habituales se agrupan en tres categorías: fallos de autenticación con la API del proveedor, rechazos por validación de datos del comprador y errores de conexión entre tu servidor y el gateway.
- Error de autenticación API: claves pública/privada incorrectas o caducadas
- Modo sandbox activo en producción: la pasarela está en pruebas y no procesa pagos reales
- Certificado SSL inválido o mixto: la pasarela rechaza conexiones no seguras
- Conflicto de plugins: otro plugin intercepta la petición de pago
- Moneda no soportada: la divisa configurada no es compatible con el gateway
- Webhook mal configurado: el proveedor no puede notificar el resultado del pago
Cómo diagnosticar el problema paso a paso
Activa el modo depuración de WooCommerce (WooCommerce → Ajustes → Avanzado → Registros) y reproduce el error. Esto genera un log detallado con la respuesta exacta del proveedor de pagos.
Abre la consola del navegador (F12 → Console) durante el proceso de pago. Algunos errores de JavaScript impiden que el formulario de pago se envíe correctamente, especialmente con pasarelas que inyectan iframes como Stripe o Redsys.
Prueba con un tema básico como Storefront y desactiva todos los plugins excepto WooCommerce y la pasarela de pago. Si el problema desaparece, reactiva los plugins uno a uno para encontrar el conflicto.
Solucionar problemas con PayPal en WooCommerce
PayPal es la pasarela más utilizada y también la que más problemas de configuración presenta. Desde 2023 PayPal ha migrado al sistema PayPal Commerce Platform, lo que obliga a reconectar las credenciales antiguas.
Si usas el plugin oficial «WooCommerce PayPal Payments», verifica que la conexión OAuth esté activa en WooCommerce → Ajustes → Pagos → PayPal. Si aparece el botón «Conectar con PayPal», tu integración se ha desconectado.
El IPN (Instant Payment Notification) de PayPal debe apuntar a la URL correcta de tu tienda. Ve a tu cuenta de PayPal → Configuración → Notificaciones → IPN y asegúrate de que la URL sea https://tutienda.com/?wc-api=WC_Gateway_Paypal.
- Revisa que las credenciales API (Client ID y Secret) sean del modo Live, no Sandbox
- Confirma que tu cuenta PayPal Business está verificada y sin restricciones
- Comprueba que la moneda de WooCommerce coincida con las admitidas por PayPal
- Desactiva la opción «Pagos por referencia» si genera conflictos
Problemas con Stripe y Redsys
Stripe requiere que el sitio cargue completamente en HTTPS y que no haya contenido mixto. Un solo recurso HTTP (una imagen, un script) puede hacer que Stripe rechace la conexión. Usa herramientas como Why No Padlock para detectar contenido mixto.
Con Redsys, el error más habitual en tiendas españolas es la firma SHA-256 incorrecta. Redsys utiliza una clave de encriptación que debe coincidir exactamente entre el TPV virtual y WooCommerce. Si has cambiado de hosting o restaurado una copia de seguridad, regenera la clave en el portal de Redsys.
Otro problema frecuente con Redsys es la URL de notificación. El TPV virtual envía el resultado del pago a una URL que debe ser accesible públicamente. Si tu servidor bloquea peticiones externas o tiene reglas de firewall restrictivas, la notificación se pierde y el pedido queda en «Pendiente de pago».
Certificado SSL y requisitos de seguridad
Todas las pasarelas de pago exigen una conexión HTTPS válida. Un certificado SSL caducado, autofirmado o con errores de cadena provocará que la pasarela rechace cualquier transacción.
Verifica el estado de tu certificado con SSL Labs (ssllabs.com/ssltest). El resultado debería ser A o A+. Si obtienes una puntuación inferior, contacta a tu proveedor de hosting para que actualice la configuración TLS.
Asegúrate también de que WordPress esté configurado para forzar HTTPS. En Ajustes → Generales, tanto la Dirección de WordPress como la Dirección del sitio deben empezar por https://. Instala un plugin como Really Simple SSL si necesitas forzar la redirección.
Cómo prevenir futuros problemas
Los problemas con pasarelas de pago suelen aparecer después de actualizaciones de WordPress, WooCommerce o del propio plugin de la pasarela. Establece un protocolo de pruebas antes de actualizar: realiza una compra de prueba después de cada actualización importante.
Configura alertas de monitorización para detectar caídas en las transacciones. Herramientas como UptimeRobot pueden verificar que la página de checkout responde correctamente. También puedes configurar alertas en el panel del proveedor de pagos para recibir notificaciones si las transacciones caen por debajo de un umbral.
- Realiza una compra de prueba tras cada actualización
- Mantén siempre una pasarela de pago alternativa activa
- Configura alertas en el proveedor de pagos para transacciones fallidas
- Haz backup antes de actualizar plugins relacionados con pagos
- Revisa los logs de WooCommerce semanalmente
Puntos clave
- Revisa los logs de WooCommerce antes de cambiar configuraciones al azar
- Verifica que no estás en modo sandbox/pruebas en la pasarela
- Un certificado SSL válido es requisito imprescindible para procesar pagos
- Prueba con tema y plugins por defecto para descartar conflictos
- Mantén siempre una pasarela de pago alternativa configurada
- Realiza una compra de prueba después de cada actualización
¿Tu tienda sigue sin procesar pagos?
Nuestro equipo de mantenimiento WooCommerce diagnostica y soluciona problemas con pasarelas de pago en menos de 24 horas. Recupera tus ventas cuanto antes.
Solicitar presupuesto