Available hooks for customizing the free version of the Redsys payment gateway for WooCommerce.
WooCommerce Redsys Lite is the free Redsys gateway for WooCommerce (basic card, Bizum and Google Pay), with more than 20,000 active installs. As a standard WooCommerce payment gateway it integrates cleanly with WooCommerce's own action and filter system, so you can adjust where it appears, react to a successful payment, and trigger your own fulfilment — without forking the plugin.
The free version exposes a deliberately small surface focused on the essentials. The standard WooCommerce extension points below work with the Lite gateway today. The plugin's own, gateway-specific hook library (110+ actions and filters covering tokenization, pre-authorization, subscriptions, IPN internals, express checkout, agentic commerce and more) is part of the Premium plugin.
These are standard WooCommerce core hooks you can use to detect, reorder or conditionally show the Lite Redsys gateway. They apply to any payment gateway, including the free Redsys gateway.
WooCommerce core filter that lists the registered gateway classes. The Lite plugin uses it to register its gateway; you can read the list to confirm the gateway is present.
| Name | Type | Description |
|---|---|---|
$gateways | array | Array of payment gateway class names. |
Source: WooCommerce core. Used by WooCommerce Redsys Lite to register its gateway.
WooCommerce core filter that controls which gateways are offered at checkout. Use it to hide or show the Lite Redsys gateway based on cart total, country, customer role, or any other condition.
| Name | Type | Description |
|---|---|---|
$available_gateways | array | Map of gateway id to gateway instance currently available. |
Source: WooCommerce core.
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;
}React to the outcome of a Redsys payment using WooCommerce's standard order hooks. Because the Lite gateway marks the WooCommerce order as paid through the normal order pipeline, these core hooks fire reliably after a successful Redsys notification.
WooCommerce core action fired on the order-received (thank you) page. A good place to render a custom confirmation message after a Redsys payment.
| Name | Type | Description |
|---|---|---|
$order_id | int | The WooCommerce order id. |
Source: WooCommerce core.
WooCommerce core action fired whenever an order changes status. Use it to trigger fulfilment, CRM sync or notifications when a Redsys order moves to processing or completed.
| Name | Type | Description |
|---|---|---|
$order_id | int | The WooCommerce order id. |
$from | string | Previous status. |
$to | string | New status. |
Source: WooCommerce core.
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.
}
}Need more hooks and the full API? The free version covers the essentials; the Premium plugin opens up the rest of the integration surface.
| Capability | Lite (free) | Premium |
|---|---|---|
| Standard WooCommerce gateway hooks | Yes | Yes |
| Plugin-specific actions & filters | Limited | 114 documented hooks |
| Payment lifecycle, tokenization & pre-auth hooks | — | Yes |
| Express checkout & subscriptions hooks | — | Yes |
| REST API for external integrations (A2A / UCP) | — | Yes |
Explore the complete library in the Premium hooks reference and the REST API reference.
The full hooks library and REST API ship with the WooCommerce Redsys Gateway Premium plugin.