Inicio rápido en 10 minutos

Al final de esta guía tendrás el plugin instalado, tu licencia activada, una pasarela conectada en modo sandbox y un producto de suscripción funcional con un pedido de prueba. Asumimos un WordPress 6.5+ recién instalado con WooCommerce 9.0+.

1. Prerequisitos

Necesitas un sitio WordPress con WooCommerce activado y acceso de administrador. Entorno recomendado:

WordPress

6.5 o superior (probado hasta 7.0).

WooCommerce

9.0 o superior con HPOS activado.

PHP

8.1+ con bcmath, intl y openssl.

HTTPS

Obligatorio para todas las pasarelas de pago. Autofirmado en desarrollo está bien.

Memoria

256 MB mínimo. 512 MB recomendado para más de 5.000 suscripciones activas.

Verifica tu stack rápidamente desde la línea de comandos:

// Verifica que tu stack cumple los requisitos
$ wp core version
6.7.1 (probado hasta 7.0)
$ wp plugin get woocommerce --field=version
9.4.2
$ php -v
PHP 8.2.18 (cli)

2. Instalar el plugin

Puedes instalar el plugin de tres formas. Elige la que mejor encaje en tu flujo de trabajo.

$ wp plugin install ./advanced-subscriptions-for-woocommerce.zip --activate
Unpacking the package...
Installing the plugin...
Plugin installed successfully.
Activating 'advanced-subscriptions-for-woocommerce'...
Success: Plugin 'advanced-subscriptions-for-woocommerce' activated.

{
  "repositories": [
    { "type": "composer", "url": "https://plugins.joseconti.com/composer/" }
  ],
  "require": {
    "joseconti/advanced-subscriptions-for-woocommerce": "^2.0"
  }
}

3. Activar la licencia

Encontrarás tu clave de licencia en Mi cuenta → Licencias. Pégala en WooCommerce → Ajustes → Advanced Subscriptions → Licencia y pulsa Activar.

4. Conectar tu primera pasarela

Advanced Subscriptions soporta de forma nativa cuatro pasarelas para cobro recurrente: Redsys (incluida en el plugin) y Stripe, PayPal y WooPayments (cada una mediante su plugin oficial y gratuito de WooCommerce). Elige una para terminar esta guía.

Ve a WooCommerce → Ajustes → Pagos y activa la pasarela que quieras usar. El ejemplo de abajo usa Redsys; la misma idea aplica para las demás.

4.1 Introduce tus credenciales de Redsys

Pega el código de comercio, el terminal y la clave de firma desde el back office de Redsys. Activa Modo de pruebas mientras verificas la integración.

1. Código de comercio (FUC). 9 dígitos que te proporciona tu banco.
2. Terminal. Normalmente 1 para el terminal de producción, 999 para sandbox.
3. Clave de firma SHA-256. Visible en el panel de Redsys "Configuración → Datos operativos".
4. Moneda. EUR por defecto. Cámbiala solo si tu cuenta es multi-divisa.

4.2 Opcional: activa Bizum

Dentro del panel de la pasarela Redsys, marca Bizum. Los clientes verán Bizum en el checkout para compras puntuales.

4.3 ¿Qué pasarela debería elegir?

Cuatro pasarelas de pago listas para recurrente desde el primer momento. Comparativa rápida:

¿Necesitas el detalle por flujo del stack español (Bizum vs Inespay vs PSD2 Light)? Ver la página de pasarelas españolas para la matriz de compatibilidad completa.

5. Crea tu primer producto

Ve a Productos → Añadir nuevo. En la caja de datos del producto elige Suscripción simple y rellena la nueva pestaña Suscripción.

Intervalo de facturación

Con qué frecuencia se cobra al cliente. 1 mes es lo más común.

Duración

Hasta que se cancele para evergreen, o un número finito de renovaciones (ej. 12 meses).

Cuota de alta

Cuota única opcional añadida solo al primer pedido.

Periodo de prueba

Periodo gratis antes de la primera renovación pagada. Déjalo en 0 por ahora.

Día de anclaje

Día del mes al que se ancla la renovación. Déjalo sin definir; por defecto usa la fecha del pedido.

Publica el producto y haz un pedido de prueba desde el front. Tras la confirmación de la pasarela, verás la nueva suscripción en WooCommerce → Suscripciones con estado Activa y la próxima renovación programada exactamente un mes después del pedido.

6. Verifica la renovación

No hace falta esperar un mes para verificar que el motor funciona. Dos formas:

• Desde la pantalla de detalle de la suscripción. Edita la suscripción en WooCommerce → Suscripciones, cambia la Próxima fecha de pago a un momento dentro de los próximos minutos y guarda. El planificador de reintentos la cogerá en el siguiente tick de Action Scheduler.
• Desde Action Scheduler. Ve a WooCommerce → Estado → Acciones programadas, filtra por el hook advanced_scheduled_subscription_payment, encuentra tu suscripción y pulsa Ejecutar. La renovación se dispara inmediatamente.

7. Chuleta para desarrolladores

Si quieres extender o automatizar el flujo, aquí tienes los tres puntos de entrada más comunes.

7.1 Ejemplo de hook PHP

Añade un descuento de fidelidad del 5% automáticamente tras la tercera renovación exitosa:

add_action( 'advsubs_after_renewal_paid', function ( $subscription, $renewal_order ) {
    if ( $subscription->get_payment_count() >= 3 ) {
        $subscription->apply_discount( 'LOYAL5', 'percent', 5 );
    }
}, 10, 2 );

7.2 Ejemplo de API REST

Lee una suscripción desde tu CRM. Activa la API en WooCommerce → Ajustes → Advanced Subscriptions → API y copia la clave secreta:

$ curl https://shop.example.com/wp-json/aswc-route/v1/aswc-view-subscription/482 \
    -H "X-ASWC-API-Key: <tu_clave_secreta>"

{
  "id": 482,
  "status": "active",
  "next_payment": "2026-06-09",
  "total": "19.90"
}

8. Atajos de teclado útiles

Dentro de las pantallas de admin del plugin:

• ⌘ K  — Abrir la búsqueda global.
• G S  — Saltar a la lista de Suscripciones.
• G R  — Saltar a la cola de Renovaciones.
• ?  — Mostrar el overlay de atajos.

9. Troubleshooting

Los dos errores que puedes encontrar en una primera instalación:

10. Siguientes pasos

Ya tienes una suscripción recurrente en vivo sobre una pasarela real. Desde aquí, los siguientes pasos más comunes son: