Portal de Desarrolladores

WooCommerce Redsys Lite Hooks Versión gratuita

Hooks disponibles para personalizar la versión gratuita de la pasarela de pago Redsys para WooCommerce.

Visión general

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
NombreTipoDescripcion
$gatewaysarrayArray 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
NombreTipoDescripcion
$available_gatewaysarrayMapa 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
NombreTipoDescripcion
$order_idintEl 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
NombreTipoDescripcion
$order_idintEl id de pedido de WooCommerce.
$fromstringEstado anterior.
$tostringNuevo 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.

FuncionalidadLite (gratis)Premium
Hooks estándar de pasarela de WooCommerce
Actions y filters específicos del pluginLimitado114 hooks documentados
Hooks de ciclo de vida del pago, tokenización y preautorización
Hooks de express checkout y suscripciones
REST API para integraciones externas (A2A / UCP)

Explora la biblioteca completa en la referencia de hooks Premium y la referencia de la REST API.

¿Necesitas más personalización?

La biblioteca completa de hooks y la REST API se incluyen con el plugin WooCommerce Redsys Gateway Premium.