WooCommerce Redsys Lite es la pasarela Redsys gratuita para WooCommerce (tarjeta básica, Bizum y Google Pay), con más de 20.000 instalaciones activas. Al ser una pasarela de pago estándar de WooCommerce, se integra limpiamente con el propio sistema de actions y filters de WooCommerce, de modo que puedes ajustar dónde aparece, reaccionar a un pago correcto y desencadenar tu propia preparación de pedido, sin bifurcar el plugin.
La versión gratuita expone deliberadamente una superficie pequeña centrada en lo esencial. Los puntos de extensión estándar de WooCommerce que se muestran a continuación funcionan hoy con la pasarela Lite. La propia biblioteca de hooks específica de la pasarela del plugin (más de 110 actions y filters que cubren tokenización, preautorización, suscripciones, internos de la IPN, express checkout, comercio agéntico y más) forma parte del plugin Premium.
Registro de pasarela
Estos son hooks estándar del núcleo de WooCommerce que puedes usar para detectar, reordenar o mostrar condicionalmente la pasarela Redsys Lite. Se aplican a cualquier pasarela de pago, incluida la pasarela Redsys gratuita.
woocommerce_payment_gatewaysFilter
Filtro del núcleo de WooCommerce que lista las clases de pasarela registradas. El plugin Lite lo usa para registrar su pasarela; puedes leer la lista para confirmar que la pasarela está presente.
Parámetros
Nombre
Tipo
Descripcion
$gateways
array
Array de nombres de clase de pasarela de pago.
Fuente: núcleo de WooCommerce. Usado por WooCommerce Redsys Lite para registrar su pasarela.
woocommerce_available_payment_gatewaysFilter
Filtro del núcleo de WooCommerce que controla qué pasarelas se ofrecen en el checkout. Úsalo para ocultar o mostrar la pasarela Redsys Lite según el total del carrito, el país, el rol del cliente o cualquier otra condición.
Parámetros
Nombre
Tipo
Descripcion
$available_gateways
array
Mapa de id de pasarela a instancia de pasarela actualmente disponible.
Fuente: núcleo de WooCommerce.
PHP — ejemplo
add_filter( 'woocommerce_available_payment_gateways', 'my_hide_redsys_lite_below_10' );
function my_hide_redsys_lite_below_10( $gateways ) {
// Hide the Redsys gateway for carts under 10 EUR (gateway id may vary).
if ( WC()->cart && WC()->cart->total < 10 ) {
unset( $gateways[ 'redsys' ] );
}
return $gateways;
}
Resultado del pago
Reacciona al resultado de un pago de Redsys usando los hooks de pedido estándar de WooCommerce. Como la pasarela Lite marca el pedido de WooCommerce como pagado a través del flujo de pedido normal, estos hooks del núcleo se disparan de forma fiable tras una notificación correcta de Redsys.
woocommerce_thankyouAction
Action del núcleo de WooCommerce que se dispara en la página de pedido recibido (agradecimiento). Un buen lugar para renderizar un mensaje de confirmación personalizado tras un pago de Redsys.
Parámetros
Nombre
Tipo
Descripcion
$order_id
int
El id de pedido de WooCommerce.
Fuente: núcleo de WooCommerce.
woocommerce_order_status_changedAction
Action del núcleo de WooCommerce que se dispara cada vez que un pedido cambia de estado. Úsalo para desencadenar la preparación del pedido, la sincronización con un CRM o notificaciones cuando un pedido de Redsys pasa a processing o completed.
Parámetros
Nombre
Tipo
Descripcion
$order_id
int
El id de pedido de WooCommerce.
$from
string
Estado anterior.
$to
string
Nuevo estado.
Fuente: núcleo de WooCommerce.
PHP — ejemplo
add_action( 'woocommerce_order_status_changed', 'my_redsys_lite_on_paid', 10, 3 );
function my_redsys_lite_on_paid( $order_id, $from, $to ) {
if ( 'processing' === $to || 'completed' === $to ) {
$order = wc_get_order( $order_id );
// Run your fulfilment / sync once the Redsys order is paid.
}
}
Hooks Premium y API
¿Necesitas más hooks y la API completa? La versión gratuita cubre lo esencial; el plugin Premium abre el resto de la superficie de integración.
Funcionalidad
Lite (gratis)
Premium
Hooks estándar de pasarela de WooCommerce
Sí
Sí
Actions y filters específicos del plugin
Limitado
114 hooks documentados
Hooks de ciclo de vida del pago, tokenización y preautorización