Manual de Suscripciones con Stripe para PrestaShop

Con este módulo vendes cualquier producto o combinación de tu tienda como una suscripción. Tu cliente paga en tu checkout, Stripe Billing le cobra cada periodo con su tarjeta o su cuenta guardada, y cada renovación llega a tu tienda como un pedido normal. Funciona en PrestaShop 1.7.6 a 9.x con PHP 7.1 o superior, con los temas Classic, Hummingbird y los que derivan de ellos, en multitienda y en varias monedas.

Para los módulos que quieran escuchar sus avisos o suscribir a un cliente desde fuera de la ficha, está la referencia de hooks y API.

Antes de empezar

• Una cuenta de Stripe con Billing activo. Puedes empezar en modo prueba y pasar a real cuando quieras: cada modo tiene sus claves, su webhook y sus clientes.
• Tu tienda accesible por HTTPS: Stripe avisa a la tienda de cada cobro por un webhook.
• Si tu tienda es privada (solo clientes registrados), deja abiertas las páginas module-bksubscriptions-webhook y module-bksubscriptions-subscribe: sin ellas Stripe no puede avisar de los cobros.

Instalar el módulo

1. En el back office, Módulos › Gestor de módulos › Subir un módulo y elige el zip.
2. Al instalarse aparece Pedidos › Suscripciones, con sus pestañas: Resumen, Suscripciones, Próximas entregas, Planes, Stripe y Ayuda.

El módulo crea también un estado de pedido, «Esperando el cargo bancario de la suscripción», para los adeudos que tardan unos días, y un producto oculto para la cuota de alta. No los borres.

Conectar Stripe

En Pedidos › Suscripciones › Stripe:

1. Elige el modo (prueba o real).
2. Pega la clave secreta de ese modo (sk_…), o una clave restringida (rk_…) con permiso de escritura en Customers, Checkout Sessions, Setup Intents, Subscriptions, Invoices, Invoice items, Prices, Coupons y Webhook endpoints. La clave nunca se vuelve a enseñar: si dejas el campo vacío al guardar, se conserva la que había.
3. Pega la clave publicable (pk_…) del mismo modo. Es la que permite pagar dentro de tu tienda y que tu cliente cambie su tarjeta desde su cuenta.
4. Pulsa Crear el webhook en Stripe. El módulo lo da de alta con los eventos que necesita y guarda su secreto. Al actualizar el módulo, el webhook se pone al día solo.
5. Elige los métodos de pago: la tarjeta va siempre (con 3D Secure, Apple Pay y Google Pay); el adeudo SEPA solo se ofrece en euros y ACH solo en dólares.
6. Elige el estado de los pedidos cobrados, el de las altas y las renovaciones.
7. Elige dónde paga tu cliente: en tu tienda, dentro del paso de pago (recomendado), o en la página de Stripe Checkout.

En el panel de Stripe, en Billing › Suscripciones y correos, decide cuántas veces se reintenta un cobro rechazado (Smart Retries), qué pasa cuando se agotan los intentos y si Stripe manda los correos de impago. El portal de clientes de Stripe no hace falta: tu cliente lo gestiona todo desde tu tienda.

Mientras falten la clave o el webhook, el medio de pago no aparece en el checkout y «Mis suscripciones» enseña la información sin las acciones.

Vender un producto por suscripción

Abre el producto en Catálogo › Productos y, en la pestaña Precios, marca Requiere suscripción. Se despliega el resto:

Debajo eliges qué combinaciones se venden como compra única (sin suscripción) y qué complementos recurrentes se ofrecen con el producto: en la ficha salen como una casilla («Añadir Soporte · 9 € cada mes»), nunca marcada de entrada.

Si solo una combinación se vende por suscripción, déjala sin marcar en el producto y créale su plan en Pedidos › Suscripciones › Planes. La lista de Planes enseña todos los planes de la tienda con su resumen.

Que la suscripción sea digital o con envío lo dice el propio producto (virtual o no), y la suscripción lo copia al darse de alta.

Qué ve tu cliente

En la ficha, cada cuánto se renueva y lo que pagará después, y la casilla de cada complemento.

En el carrito, el total es lo que paga hoy. Debajo, en pequeño, lo que se cobrará después («Después, 19,90 € cada mes desde el 14 nov 2026»), sumado por periodo. Una línea que hoy vale 0 (una prueba gratis) dice lo que costará y desde cuándo. En el mismo carrito caben productos normales y suscripciones de periodos distintos, y se paga todo de una vez.

En el pago, con el pago en la tienda, el formulario de Stripe aparece dentro del paso de pago con tarjeta, Apple Pay, Google Pay y, según la moneda, SEPA o ACH. El 3D Secure se hace en la página. Un carrito con suscripciones solo se puede pagar con este módulo; los carritos sin suscripción siguen con tus otros medios de pago.

Tras pagar, la confirmación dice si la suscripción ya está activa o, con un adeudo bancario, que empieza cuando el banco confirme el cargo.

En «Mis suscripciones» (en su cuenta), su tarjeta de pago con Cambiar, y una tarjeta por suscripción con lo siguiente que va a pasar y su acción:

• Próxima entrega o cobro, fin de la prueba, «Pausada hasta…» con Reanudar ya, «Termina el…» con Mantener, «Pago pendiente: actualiza la tarjeta», o «Terminó el…» con Volver y lo que cuesta hoy.
• La dirección de facturación y, con envío, la dirección de envío y el transportista, con Cambiar. Si el cambio cambia el impuesto, se le dice el importe nuevo antes.
• Las tres próximas entregas, con Saltar y Deshacer.
• Las facturas de cada pedido de la suscripción, las de tu tienda.
• Pausar (con la fecha de vuelta en cada opción) y Darme de baja, que enseña la fecha real en que termina y le ofrece pausar en su lugar.

Cada renovación, un pedido

Cada vez que Stripe cobra un periodo, la tienda crea un pedido con las líneas de la suscripción al precio cobrado y, si lleva envío, el transportista y la dirección vigentes con el envío de esa entrega. El pedido lleva su pago con la referencia de Stripe y un mensaje privado con la suscripción, así que cualquier ERP o conector lo factura como los demás.

Con un adeudo SEPA o ACH, el pedido del alta nace en «Esperando el cargo bancario de la suscripción» y pasa a cobrado cuando el banco confirma el cargo, días después. Si el adeudo falla, el pedido pasa a «Error en el pago» y no nace ninguna suscripción.

El día a día en el back office

Resumen: arriba, lo que requiere atención (impagos con su siguiente intento, entregas sin transportista o con la dirección sustituida, pausas que terminan esta semana y bajas dentro de la permanencia); vacío, dice «Nada pendiente.». Debajo, las cifras: activas, en prueba, pausadas, terminan este mes, ingresos recurrentes al mes por moneda, cobrado en 30 días y bajas en 30 días.

Suscripciones: la lista, con pestañas por estado (Todas, Activas, En prueba, Pausadas, Pago pendiente, Terminan, Terminadas). Cada fila abre su ficha: el estado, el cliente, el importe, lo siguiente, las líneas, las direcciones y el transportista, los pedidos y la historia entera (alta, cada cobro con su pedido, impagos, pausas, cambios y bajas, con quién lo hizo). Desde la ficha puedes abrirla en Stripe, Reintentar el cobro ahora, pausar o reanudar, cambiar la dirección o el transportista y dar de baja al final del periodo o en el momento.

Próximas entregas: las de los próximos 30 días de las suscripciones con envío, con las saltadas marcadas. Se exporta a CSV para preparar el almacén.

Impagos

Cuando Stripe no puede cobrar una renovación, la suscripción pasa a pago pendiente: aparece en «Requiere atención» con la fecha del siguiente intento, y tu cliente ve «Pago pendiente: actualiza la tarjeta». Stripe reintenta según lo que hayas decidido en su panel. Si el cliente cambia la tarjeta, el cobro pendiente se repite al momento con la nueva. Desde la ficha puedes reintentarlo tú. Cuando se cobra, llega el pedido de la renovación. Si se agotan los intentos, pasa lo que hayas elegido en Stripe (normalmente, la suscripción termina).

Bajas, pausas y vueltas

• Baja: termina al final del periodo pagado (o al final de la permanencia). Hasta entonces, «Mantener» la deshace. Desde el back office también puedes darla de baja en el momento.
• Pausa: el cliente elige cuántos periodos, hasta el máximo del plan; durante la pausa no se cobra ni se envía. Puede reanudarla antes.
• Saltar una entrega: es pausar un periodo; se deshace desde la misma tarjeta.
• Volver: una suscripción terminada se puede retomar desde «Mis suscripciones». El botón dice lo que cuesta hoy (el periodo, los atrasados que hayas configurado y la cuota de vuelta) y lleva al checkout con su línea en el carrito.

Multitienda y monedas

El módulo se instala en todas las tiendas. Cada tienda tiene su configuración de Stripe y su webhook; los planes se guardan para todas las tiendas o para la del contexto. Cada suscripción se cobra en la moneda en que se contrató, con el precio de renovación de esa moneda. Si un cliente tiene suscripciones en dos monedas, tiene una tarjeta de pago por moneda en su cuenta.

Preguntas frecuentes

¿Puedo seguir usando el módulo oficial de Stripe? Sí. Este módulo solo cobra los carritos con suscripciones.

¿Qué pasa si desinstalo el módulo? Las tablas no se borran: dicen de quién es cada suscripción que Stripe sigue cobrando. Antes de desinstalarlo, termina las suscripciones en curso.

¿Dónde veo lo que ha pasado con una suscripción? En su ficha del back office, en la historia: cada cobro, impago, pausa, cambio y baja, con quién lo hizo.