Redsys para WooCommerce: cómo integrarlo de verdad (y lo que nadie te dice antes)

Antes del plugin, hay un paso que casi ningún tutorial menciona: contratar el TPV Virtual con tu banco. Te cuento el proceso completo de integrar Redsys en WooCommerce, con sus partes menos cómodas incluidas.

Redsys es la pasarela de pago que hay detrás de la mayoría de bancos españoles cuando aceptas pagos con tarjeta online. Lo que casi ningún tutorial menciona antes de hablarte del plugin es el paso previo: Redsys no se contrata directamente, se contrata a través de tu banco, pidiendo un TPV Virtual. Sin eso, no tienes número de comercio ni clave secreta, y el plugin no sirve de nada.

El proceso real, de principio a fin

  1. Contrata el TPV Virtual con tu banco. Este trámite lo lleva tu entidad bancaria, no Redsys ni WordPress. Tarda normalmente varios días — no lo dejes para el último momento antes de lanzar la tienda.
  2. Recibe tus credenciales: número de comercio (FUC), terminal y clave secreta (SHA-256). Te las da el banco al activar el TPV.
  3. Instala el plugin de Redsys en tu WooCommerce y mete esas credenciales en la configuración del método de pago.
  4. Prueba en el entorno de pruebas de Redsys antes de pasar a producción — el banco te facilita credenciales de test independientes para esto. No pases a real sin haber probado un pago completo, incluyendo qué pasa si el pago falla o se cancela a mitad.
  5. Activa el entorno real solo cuando el flujo completo (pago correcto, pago fallido, notificación a WooCommerce) haya funcionado en pruebas.

Lo que no suelen contarte

La integración de Redsys tiene fama merecida de ser menos fluida que pasarelas como Stripe: la documentación es más técnica, el proceso de alta con el banco añade días de espera que no controlas tú, y el entorno de pruebas a veces se comporta de forma distinta al real de maneras que solo descubres probando. No es un “instala y listo” de cinco minutos, aunque el plugin en sí sea sencillo.

Buena noticia: si ya tienes Redsys, es muy probable que Bizum venga incluido en la misma integración sin configuración adicional — antes de montar nada aparte, revisa los ajustes de tu pasarela. Solo si no lo trae, tiene sentido mirar la alternativa manual que explico en añadir Bizum como método de pago en WooCommerce.

Mantenimiento después de activarlo

Mantén el plugin actualizado — las pasarelas de pago son de las integraciones donde una versión desactualizada puede dejarte de cobrar de un día para otro sin previo aviso. Y revisa periódicamente que las notificaciones de pago (el aviso que Redsys manda a WooCommerce para confirmar un pedido como pagado) siguen llegando correctamente — es el fallo silencioso más habitual: el cliente paga, pero WooCommerce nunca se entera y el pedido se queda como pendiente.

Hablemos

¿Tienes un proyecto
en mente?

Cuéntame lo que necesitas. Te doy una opinión honesta — solo trabajo en lo que realmente tiene sentido para tu negocio.

Empecemos