VibeFox Redsys for WooCommerce — Ayuda
Requisitos
WordPress: 6.2 o posterior.
WooCommerce: 8.0 o posterior, instalado y activo. El plugin no se activa sin él.
PHP: 8.0 o posterior.
Cuenta de comercio Redsys: tu banco (la entidad adquirente que te dio el TPV virtual de Redsys) te proporciona el código de comercio (FUC), el número de terminal y el acceso al panel de administración de Redsys, donde se muestra la clave secreta SHA-256 de cada entorno. La clave del entorno de pruebas es distinta de la del real. La notificación online (HTTP) debe estar activa para tu terminal. Consulta con tu banco si no estás seguro.
Moneda de la tienda: una de las monedas que admite el plugin (ver Configuración), y tu banco debe haber habilitado para ella el terminal de Redsys. La mayoría de los terminales aceptan solo EUR.
Sitio accesible: Redsys debe poder acceder a tu sitio desde internet, sin inicio de sesión ni bloqueo de cortafuegos, para enviar las notificaciones de pago.
Clave de licencia de VibeFox: se compra en vibefox.net. Una clave funciona en un dominio.
Instalación
1. En WordPress ve a Plugins > Add New > Upload Plugin, elige el archivo ZIP del plugin y haz clic en Install Now. También puedes subir la carpeta wcp_redsys_gateway a /wp-content/plugins/ por FTP.
2. Haz clic en Activate.
3. Abre la configuración: WooCommerce > Settings > Payments > Redsys > Manage, o haz clic en Settings debajo del nombre del plugin en la página de Plugins.
4. Introduce tu clave de licencia de VibeFox en el bloque de licencia de la parte superior de la página y haz clic en Activate.
5. Introduce tu código de comercio, el terminal y la clave secreta de cada entorno (ver Configuración).
6. Activa Enable/Disable. Prueba un pago con Test Mode activado y después desmarca Test Mode para aceptar pagos reales.
Configuración
Todos los ajustes están en una sola página: WooCommerce > Settings > Payments > Redsys. Encima de los campos, la página te avisa cuando falta el código de comercio o no está formado solo por dígitos, cuando una clave secreta no es una clave SHA-256 de Redsys válida, cuando la clave del modo actual está vacía (en ese caso el método de pago se oculta en la finalización de compra) y cuando la moneda de la tienda no está admitida. Mientras el modo de prueba está activo, muestra Test mode is active: payments go to the Redsys test environment (SIS-T), no real money is charged. Tras guardar, los avisos se actualizan de inmediato con la nueva configuración. En la lista de métodos de pago, Redsys aparece como pendiente de configuración hasta que el código de comercio, el terminal y la clave del modo actual sean válidos.
General
Enable/Disable: Enable Redsys Gateway activa o desactiva el método de pago. Por defecto: desactivado.
Title: el nombre del método de pago que ven los clientes en la finalización de compra. Por defecto: Credit/Debit Card (Redsys).
Description: el texto que se muestra debajo del método de pago en la finalización de compra. Por defecto: Pay securely with your credit or debit card via Redsys.
Cuenta Redsys
Tu banco te da el código de comercio, el terminal y el acceso al panel de administración de Redsys, donde se muestra la clave secreta SHA-256 de cada entorno. La sección enlaza con el panel de administración de Redsys.
Merchant Code (FUC): tu código de comercio de Redsys, de hasta 9 dígitos. Al guardar se elimina cualquier carácter que no sea un dígito.
Terminal Number: el número de terminal asignado por tu banco, de hasta 3 dígitos. Por defecto: 1. Un campo vacío se guarda como 1.
Secret Key (SHA-256) — live: la clave SHA-256 en Base64 del entorno real (de producción). Se usa cuando el modo de prueba está desactivado.
Modo de prueba (SIS-T)
El entorno de pruebas de Redsys tiene su propia clave secreta. La sección muestra los datos públicos de prueba de Redsys: código de comercio 999008881, terminal 1, clave sq7HjrUOBfKmC576ILgskD5srU870gJ7, tarjeta 4548 8100 0000 0003, caducidad 12/49, CVV 123. No se cobra dinero real en modo de prueba.
Test Mode: Enable test mode envía los pagos y reembolsos al entorno de pruebas de Redsys (SIS-T) y los firma con la clave de prueba. Por defecto: activado. Desmárcalo para aceptar pagos reales. Mientras está activo, la finalización de compra muestra TEST MODE: Redsys test environment, no real money is charged. debajo del método de pago.
Secret Key (SHA-256) — test: la clave SHA-256 en Base64 del entorno de pruebas. Usa tu propia clave de prueba o la clave pública de prueba indicada arriba.
Página de pago y pedidos
Commerce Name: el nombre de la tienda que se muestra en la página de pago de Redsys, de como máximo 25 caracteres. Por defecto: el nombre de tu sitio, recortado a 25 caracteres.
Order Status After Payment: el estado del pedido tras un pago correcto. El estado se establece una sola vez, así que el cliente recibe un solo correo.
Notificaciones de pago
Redsys informa de cada pago a la dirección de notificación de tu tienda. Tiene el formato https://your-site/wc-api/rdsg_redsys/ y se muestra en esta sección. El plugin la envía a Redsys con cada pago, así que no hay nada que copiar en el panel de Redsys. La notificación online (HTTP) debe estar activa para tu terminal. Consulta con tu banco si los pedidos siguen en pendiente de pago tras un pago correcto. Las notificaciones sin firma válida se rechazan. Sin la notificación, un pedido no se marca como pagado.
Avanzado
Debug log: Enable debug logging escribe los detalles de pagos, notificaciones y reembolsos en WooCommerce > Status > Logs, con origen wcp_redsys_gateway. Los errores siempre se registran, también cuando esta opción está desactivada. Las claves, las firmas y los datos de tarjeta nunca se registran. Por defecto: desactivado.
Delete Data: Delete the gateway settings when the plugin is deleted. Si está activado, al eliminar el plugin se borran los ajustes de la pasarela y los registros del plugin. Por defecto: desactivado.
Monedas admitidas
EUR, USD, GBP, JPY, CHF, CAD, AUD, NZD, NOK, SEK, DKK, PLN, CZK, HUF, BGN, RON, ILS, INR, MYR, SGD, THB, SAR, ZAR, RUB, BRL, MXN, ARS, CLP, COP, PEN, CNY, TWD. El método de pago se oculta para las demás monedas. En la página Pay for order cuenta la moneda del pedido.
Finalización de compra
El cliente elige el método de pago (por defecto Credit/Debit Card (Redsys)) y realiza el pedido. El pedido pasa a pendiente de pago y el cliente ve Redirecting to Redsys for payment. Please wait..., y a continuación va a la página de pago de Redsys de tu banco. Si el navegador no continúa solo, el cliente hace clic en Pay via Redsys. En la página de Redsys, el cliente paga con tarjeta con 3-D Secure, o con Bizum u otro método que tu banco haya habilitado para el terminal. La página usa el idioma de tu tienda (español, inglés, catalán, francés, alemán, italiano, portugués y más), o el inglés para los demás idiomas.
El importe se envía en las unidades menores de la moneda del pedido, por ejemplo EUR 43,45 como 4345, y JPY o CLP sin decimales. El pago se describe como Order con el número de pedido y el nombre de tu sitio. El stock se reduce cuando se confirma el pago, no antes.
Después de pagar, el cliente vuelve a la página de pedido recibido de tu tienda. El pedido solo se marca como pagado cuando Redsys lo confirma mediante la notificación firmada. Hasta que llegue, la página muestra Redsys is confirming your payment. If you completed the payment, your order will be updated in a few moments — please do not pay again.
Si el cliente cancela o Redsys rechaza el pago, Redsys devuelve al cliente a tu tienda. En un pedido de la finalización de compra, el pedido se cancela de la forma estándar de WooCommerce y el carrito se conserva. En un pedido creado en la administración (un enlace de pago), el cliente vuelve a la página Pay for order con el mensaje The Redsys payment was not completed. You can try again or choose another payment method., y el pedido no se cancela. La página de redirección de tu tienda también ofrece Cancel order & restore cart o, para los pedidos creados en la administración, Choose another payment method.
Un cliente puede volver a pagar un pedido no pagado desde la página Pay for order. Cada intento recibe un nuevo número de pedido de Redsys, y un pago realizado desde cualquiera de ellos, por ejemplo desde una segunda pestaña del navegador, sigue siendo reconocido.
Si el pedido no se puede enviar a Redsys, el cliente ve un mensaje breve y puede elegir otro método de pago: Redsys payments are not configured correctly. Please choose another payment method or contact us., un mensaje de que la moneda no se acepta, o The order total must be greater than zero.
El método de pago funciona en la finalización de compra clásica, en el bloque de Finalizar compra y en la página Pay for order. Es compatible con WooCommerce High-Performance Order Storage (HPOS).
El plugin procesa pagos únicos, autorizados y capturados de inmediato en la página de Redsys. No tiene formulario de tarjeta en tu propio sitio (InSite o iframe), ni tarjetas guardadas, pagos con un clic o tokenización, ni suscripciones o pagos recurrentes, ni preautorización con captura posterior, ni notificaciones SOAP.
Pedidos y reembolsos
Estados del pedido
Pending payment: el cliente fue enviado a Redsys y aún no ha pagado, o la notificación de Redsys todavía no ha llegado. La nota del pedido dice Awaiting Redsys payment.
Processing, Completed or On Hold: el pago fue confirmado. El estado sigue a Order Status After Payment. La nota del pedido muestra el número de pedido de Redsys (Ds_Order), el código de autorización y el código de respuesta, marcado como [TEST] en los pagos de prueba. El ID de transacción del pedido es el número de pedido de Redsys.
On hold after payment: Redsys informó de un importe o una moneda distintos al total del pedido, llegó un pago de prueba mientras la tienda estaba en modo real (no se cobró dinero real), o el pago llegó después de que el pedido se cancelara. La nota del pedido lo explica. Revisa el pago en el panel de administración de Redsys y después envía el pedido o reembolsa el pago.
Failed: el pago fue rechazado o cancelado en Redsys. La nota del pedido muestra el código de respuesta y, para los códigos más frecuentes, un motivo breve como Insufficient funds, Card expired o Cancelled by the customer. Solo un pedido que aún espera el pago pasa a Fallido. Un pedido pagado o cerrado nunca cambia por un intento rechazado. El intento solo se anota.
Cancelled: el cliente canceló el pago, o tú o el tiempo de espera de reserva de stock de WooCommerce cancelasteis el pedido.
Si llega un segundo pago distinto para un pedido que ya está pagado o reembolsado, el pedido no cambia. Una nota te pide que reembolses el pago duplicado en el panel de administración de Redsys. Si Redsys indica que un pago sigue en curso, se añade una nota y el pedido espera el resultado final.
Reembolsos
Abre el pedido, haz clic en Refund, introduce el importe y haz clic en el botón de reembolso del método de pago de Redsys (por defecto Refund via Credit/Debit Card (Redsys)). Se admiten reembolsos totales y parciales. El reembolso se envía mediante la API REST de Redsys al entorno en el que se hizo el pago (prueba o real), se firma con la clave de ese entorno y se comprueba la firma de la respuesta. Si Redsys no acepta el reembolso, WooCommerce muestra el error y no se registra ningún reembolso. Un reembolso correcto se añade a las notas del pedido con el número de pedido de Redsys y el motivo.
Los reembolsos hechos en el panel de administración de Redsys no se registran como reembolsos de WooCommerce. Cuando Redsys envía una notificación de ellos, se añade una nota al pedido. Si hace falta, crea un reembolso manual en WooCommerce sin usar el botón de reembolso de Redsys.
Clave de licencia
El plugin funciona con una clave de licencia de VibeFox de vibefox.net. El bloque de licencia está en la parte superior de WooCommerce > Settings > Payments > Redsys. Pega la clave en License key y haz clic en Activate. El bloque muestra el estado, por ejemplo la fecha hasta la que la licencia está activa y tu dominio. Usa Check now para volver a comprobar el estado, Change key para introducir otra clave y Remove key para quitarla de este sitio. El enlace Manage licenses and domains in your account abre tu cuenta de vibefox.net.
Una clave funciona en un dominio. Quitar la clave de un sitio no libera su plaza de dominio. Libérala en tu cuenta de vibefox.net.
Sin una clave activa, Redsys no se muestra a los clientes en la finalización de compra. Si un pago se inicia de todos modos, el cliente ve This payment method is not available. Please choose another one. Los administradores de la tienda que han iniciado sesión siguen viendo el método de pago, marcado como (unlicensed — visible to admins only), para que puedas configurar y probar el plugin antes de comprar una clave. Aparece un recordatorio en la página de Plugins y en las páginas de WooCommerce. Los pedidos existentes no se ven afectados: los pagos ya iniciados se siguen confirmando y los reembolsos funcionan.
Cuando una licencia caduca, el plugin sigue funcionando, pero las actualizaciones y el soporte necesitan renovación. El estado se vuelve a comprobar automáticamente en segundo plano.
Resolución de problemas
Redsys no aparece en la finalización de compra: comprueba que la licencia esté activa, que Enable/Disable esté activado, que el código de comercio y el terminal estén rellenados y que el modo actual tenga una clave válida: Secret Key (SHA-256) — test en modo de prueba, Secret Key (SHA-256) — live en modo real. Comprueba que la moneda de la tienda (en la página Pay for order, la moneda del pedido) esté en la lista de monedas admitidas. La página de ajustes muestra un aviso para cada uno de estos problemas.
El pago se completó, pero el pedido sigue en Pending payment: la notificación de Redsys no llegó a tu tienda. Pide a tu banco que compruebe que la notificación online (HTTP) está activa para tu terminal. Comprueba que la dirección que aparece en Notificaciones de pago es accesible desde internet sin inicio de sesión, sin página de mantenimiento y sin bloqueo de cortafuegos. Activa Debug log y revisa WooCommerce > Status > Logs, origen wcp_redsys_gateway.
La notificación responde Forbidden: la firma no coincidía con la clave secreta del entorno en el que se inició el pago, o el código de comercio de la notificación no es el tuyo. Comprueba que las claves secretas y el código de comercio de la configuración son los de tu terminal.
La notificación responde Order not found: la notificación estaba firmada correctamente, pero ningún pedido de esta tienda usa ese número de pedido de Redsys.
La notificación responde Busy: el pedido estaba siendo procesado por otra notificación en ese mismo momento. Redsys reintenta la notificación.
La notificación responde Bad request: la petición no tenía parámetros de Redsys o estaban mal formados. No llegó desde Redsys en el formato esperado.
El pedido está On hold after payment: lee la nota del pedido. El importe o la moneda pagados no coincidían con el pedido, llegó un pago de prueba mientras la tienda está en modo real, o el pago llegó después de cancelar el pedido. Envía el pedido o reembolsa el pago.
Los pagos de prueba no confirman pedidos en modo real: un pago de prueba nunca paga un pedido mientras Test Mode está desactivado. En su lugar, el pedido se pone en espera con una nota. Usa el modo de prueba con la clave de prueba para los pagos de prueba.
El reembolso falla: lee el error. Redsys refund: the merchant code or the TEST secret key is not configured. (o LIVE) significa que falta la clave del entorno del pago. Los códigos de error de Redsys se explican en el mensaje, por ejemplo SIS0057 (el importe supera lo que queda del pago), SIS0056 (no se encontró el pago original; otro entorno o terminal), SIS0042 (error de firma; revisa la clave de este entorno), SIS0026 (código de comercio o terminal desconocido) y SIS0027 (moneda no configurada para el terminal). Si no se puede contactar con Redsys, el reembolso no se realiza. Inténtalo más tarde.
Tu terminal acepta una moneda que no está en la lista: los desarrolladores pueden cambiar la lista de monedas con el filtro rdsg_currency_codes. Añade una moneda solo si tu banco la ha habilitado para el terminal.
Tras actualizar desde la versión 1.0: la clave que usaste en modo de prueba está ahora en Secret Key (SHA-256) — test. Introduce la clave real antes de desmarcar Test Mode. Los pedidos creados con la versión 1.0 siguen recibiendo notificaciones y reembolsos.
El bloque de licencia muestra un error: sigue el mensaje del bloque. Por ejemplo, si la clave ya se usa en otro dominio, libera una plaza en tu cuenta de vibefox.net y haz clic en Check now. Si cambió la dirección del sitio, haz clic en Check now para activar la clave en el nuevo dominio. Si no se puede contactar con el servidor de licencias, el plugin sigue funcionando con el último estado conocido.
Desinstalación
Desactivar el plugin conserva todos los datos. Para eliminarlo, desactívalo y bórralo en la página Plugins. La clave de licencia y el estado de licencia de este plugin siempre se eliminan. Los ajustes de la pasarela y los registros del plugin solo se eliminan si Delete Data estaba activado; si no, se conservan para una futura reinstalación. Los datos de Redsys guardados en los pedidos siempre se conservan, porque documentan los pagos y son necesarios para los reembolsos. Los pedidos existentes conservan sus notas de pago y sus ID de transacción.
Redsys es una marca registrada de su respectivo propietario. Este plugin no está afiliado a Redsys ni cuenta con su respaldo.