Cómo integrar Redsys con WooCommerce en España

integrar Redsys WooCommerce TPV virtual pagos con tarjeta en España

Cómo integrar Redsys con WooCommerce en España

Redsys es la plataforma de pago online de los bancos españoles, conocida popularmente como TPV virtual. Si tienes WooCommerce y quieres que tus clientes paguen con tarjeta de crédito o débito a través de tu banco —CaixaBank, Santander, BBVA, Bankinter, Sabadell u otros—, necesitas integrar Redsys. Es el método de pago más habitual para tiendas online españolas porque genera confianza en el cliente y porque algunos negocios tienen condiciones ventajosas con su banco habitual.

Antes de empezar: lo que necesitas tener

Un contrato de TPV virtual con tu banco. Esto requiere ser autónomo o tener una empresa con cuenta bancaria. El banco te dará acceso al entorno de pruebas (sandbox) de Redsys con un conjunto de credenciales de prueba. Guarda bien esas credenciales porque las necesitarás para configurar el plugin.

Las credenciales que te dará el banco son: el código de comercio (Fuc), el número de terminal, y la clave secreta (Kc) para firmar las peticiones. En algunos bancos también recibirás el certificado de empresa si operas con la versión con certificado en lugar de la versión con clave SHA256.

El plugin recomendado: WCPSD2 o Redsys Gateway

Hay varios plugins de WooCommerce para Redsys en el repositorio oficial. Los más usados y actualizados son Redsys Gateway for WooCommerce y WooCommerce Redsys Gateway. Antes de instalar, verifica que el plugin esté actualizado para la versión actual de WooCommerce y que soporte el protocolo SHA256 (el SHA1 antiguo está desactivado en Redsys desde 2016).

Para instalar: Plugins → Añadir nuevo → busca «Redsys WooCommerce» → instala y activa.

Configuración del plugin paso a paso

Ve a WooCommerce → Ajustes → Pagos → Redsys Gateway → Gestionar.

Entorno: selecciona «Sandbox» para pruebas. Cuando todo funcione correctamente, cámbialo a «Producción».

Código de comercio (Fuc): el número de 9 dígitos que te ha dado el banco.

Terminal: normalmente «001» a menos que el banco te haya asignado otro.

Clave secreta: la clave Kc que te proporcionó el banco. Con esta clave se firma cada petición para verificar que viene de tu web.

Tipo de transacción: «Autorización» para cobrar inmediatamente. «Preautorización» si quieres cobrar después de confirmar disponibilidad del producto.

URL de notificación (webhook): el plugin la genera automáticamente. Es la URL a la que Redsys enviará la confirmación de pago después de que el cliente complete la transacción. Cópiala y añádela en el panel de Redsys de tu banco.

Probar la integración con las tarjetas de prueba

Redsys proporciona tarjetas de prueba para el entorno sandbox. La más básica: número 4548 8120 4940 0004, cualquier fecha de caducidad futura, CVV 123. Con esta tarjeta puedes simular un pago exitoso sin que se cargue nada real.

Haz un pedido de prueba completo: añade un producto al carrito, ve al checkout, selecciona Redsys como método de pago, completa el pago con la tarjeta de prueba y verifica que el pedido en WooCommerce pasa correctamente a estado «Procesando».

Activar en producción

Cuando las pruebas funcionan correctamente: cambia el entorno de «Sandbox» a «Producción», actualiza las credenciales con las de producción que te proporcionó el banco (son diferentes a las del sandbox), y vuelve a actualizar la URL de notificación en el panel de Redsys de tu banco con la URL de producción.

Haz un pedido real de importe mínimo (0,01€ si lo permite tu configuración de WooCommerce) para confirmar que todo funciona en producción antes de lanzar la tienda.

Problema habitual: pedidos que quedan en «Pendiente de pago»

El error más frecuente es que el pago se completa en Redsys pero el pedido en WooCommerce se queda en «Pendiente de pago» en lugar de pasar a «Procesando». Esto casi siempre es un problema con la URL de notificación: Redsys no puede acceder a ella porque está mal configurada, porque la web tiene una capa de caché que bloquea la petición POST, o porque la URL de producción no está actualizada en el panel del banco. Verifica los tres puntos en ese orden.

Hosting Web SSD ultrarrápido e ilimitado

Hosting Web SSD NVMe, 100% Ecológico y sostenible, máxima velocidad y tráfico ilimitado en tu Hosting Web, con certificado SSL gratuito 

Hosting Web logo

Hosting Web ecológico, profesional e ilimitado en España,  somos especialistas en servicios de Hosting SSD, con más de 22 años de experiencia y un equipo de profesionales altamente cualificados a su disposición las 24 Horas.