PS PrestaShop Intermedio

DataFirefly Subscriptions — Guía completa (PrestaShop 8 y 9)

Instalación, métodos de pago (tarjeta, adeudo directo SEPA, PayPal, facturación offline), planes, programador, reintentos, área de cliente y back-office del módulo de suscripciones para PrestaShop 8 y 9.

Actualizado Versión del módulo 3.0.0

Presentación

DataFirefly Subscriptions vende sus productos por suscripción en PrestaShop 8 y 9. Usted crea planes (frecuencia, descuento, prueba gratuita, cuota de alta, permanencia, número de entregas); el cliente elige su plan en la ficha de producto, paga su primer pedido y, a continuación, cada vencimiento crea automáticamente un pedido real de PrestaShop, pagado automáticamente con el método de pago que ha guardado (tarjeta, adeudo directo SEPA o PayPal) o enviado como pendiente de pago (facturación offline).

  • Precio de suscripción visible en todas partes: el descuento, la prueba gratuita y la cuota de alta se aplican en el carrito, en el pago, en el pedido y en la factura.
  • Un único motor de facturación: el programador de la tienda; cada suscripción se reserva antes de su renovación, por lo que dos ejecuciones simultáneas nunca cobran dos veces.
  • El cliente lo gestiona todo desde su cuenta: saltar una entrega, pausa, cambio de plan, cantidad, dirección, método de pago, cancelación.
  • Back-office completo: panel, lista de suscriptores, ficha con cronología, editor de planes con vista previa.

Novedades de la 3.0.0: adeudo directo SEPA (a través de Stripe o mediante fichero bancario pain.008) y PayPal, facturación offline y modo de prueba, cuota de alta, prueba realmente gratuita, descuento aplicado desde el 1.er pedido, pausa con reanudación automática, cambio de plan y de cantidad por parte del cliente, cambio de método de pago, cancelación al final de la permanencia, recordatorio antes de la renovación, grupo de clientes «suscriptores», nuevo panel, e-mails en 8 idiomas, cron por línea de comandos.

¿Suscripción o pedido recurrente? DataFirefly Subscriptions crea los pedidos en cada vencimiento y los cobra automáticamente (o los factura). Si prefiere enviar al cliente un carrito listo para pagar antes de cada vencimiento, sin cobro automático, consulte más bien el módulo DF Recurring Orders.

Instalación y actualización

  1. Descargue el ZIP desde su cuenta DataFirefly.
  2. Back-office: Módulos → Gestor de módulos → Subir un módulo y elija el ZIP.
  3. Aparece el menú Pedidos → Suscripciones: Panel, Suscriptores, Planes, Actividad, Configuración, Adeudos directos SEPA.

Requisitos: PrestaShop 8.0 a 9.x, PHP 7.4 a 8.5, una tarea programada (cron) en su proveedor de alojamiento; según los métodos elegidos: una cuenta Stripe (tarjeta, adeudo directo SEPA a través de Stripe), una cuenta PayPal Business apta para la bóveda de PayPal (pagos iniciados por el comerciante), o un identificador de acreedor (ICS) SEPA y un banco que acepte los ficheros de adeudo pain.008. Sin dependencias de Composer.

Actualización desde la 2.x: instale el ZIP 3.0.0 encima. La migración añade las nuevas columnas, repara las fechas vacías guardadas por la 2.x, recupera la tienda, la moneda y el idioma de cada suscripción, conserva su configuración (una tienda 2.x con Stripe mantiene la tarjeta como método de pago) y elimina los archivos que ya no son necesarios. No se pierde ninguna suscripción.

Al desinstalar, las suscripciones se conservan por defecto y se recuperan tras la reinstalación; la opción «Eliminar todos los datos de suscripción al desinstalar el módulo» lo borra todo.

Elegir los métodos de pago

Suscripciones → Configuración → Pago ofrece dos modos:

  • Método de pago guardado: renovaciones automáticas — usted marca los métodos que se ofrecen en el pago; el cliente elige uno, que se guarda en el 1.er pedido y se utiliza automáticamente en cada renovación. Para un carrito que contiene una suscripción, solo se ofrecen estos métodos.
  • Facturación offline — el 1.er pedido se paga con cualquiera de sus métodos de pago (transferencia, cheque…). La suscripción comienza cuando el pedido pasa a un estado pagado. Cada renovación crea un pedido «pendiente de pago» (por defecto «En espera de pago por transferencia bancaria», que envía sus datos bancarios); se envían recordatorios al cliente y la suscripción se suspende si el pedido sigue sin pagarse.

Métodos disponibles en el modo «método de pago guardado» (cada tarjeta indica «Listo» o «Por configurar»):

  • Tarjeta (Stripe) — tarjeta guardada con 3-D Secure, cobrada en cada renovación.
  • Adeudo directo SEPA (Stripe) — el IBAN se introduce en el formulario seguro de Stripe, que gestiona el mandato. El banco confirma un adeudo al cabo de unos días: el pedido permanece «Pendiente de adeudo directo SEPA» y pasa a «Pago aceptado» cuando Stripe lo confirma; el programador comprueba el resultado, sin necesidad de ningún webhook adicional.
  • PayPal — el cliente da su aprobación una sola vez en PayPal; su cuenta se guarda en la bóveda de PayPal y las renovaciones se cobran sin nueva aprobación. Cree una aplicación REST en el espacio para desarrolladores de PayPal (credenciales sandbox y después de producción); su cuenta PayPal Business debe estar autorizada para los pagos guardados («Vault»).
  • Adeudo directo SEPA (fichero bancario) — el cliente firma una orden de domiciliación SEPA en su tienda (titular, IBAN verificado, BIC opcional, casilla de firma). Usted mismo transmite los adeudos a su banco: consulte «Adeudos directos SEPA» más abajo. Indique el nombre del acreedor, su identificador de acreedor (ICS) SEPA, y el IBAN y el BIC de la cuenta de abono.
  • Modo de prueba — tarjetas simuladas (números de prueba de Stripe), sin ningún pago real: para ensayar todo el ciclo antes de la puesta en producción.

Los adeudos directos SEPA solo se ofrecen para carritos en euros.

Ajustes: tarjeta, adeudo directo SEPA y PayPal para las renovaciones automáticas, o facturación offline
Ajustes: tarjeta, adeudo directo SEPA y PayPal para las renovaciones automáticas, o facturación offline

Claves y webhook de Stripe

Introduzca las claves públicas y secretas del modo elegido (test o live); las claves secretas guardadas nunca vuelven a mostrarse (dejar el campo vacío conserva la clave). A continuación, cree un webhook en Stripe hacia la URL indicada, con los eventos payment_method.detached, charge.refunded y charge.dispute.created, y pegue el secreto de firma whsec_…. Los eventos sin firma se rechazan y cada evento solo se procesa una vez.

Crear un plan

Suscripciones → Planes → Nuevo plan (o desde la pestaña Módulos de la ficha de producto):

  • Producto (búsqueda por nombre, referencia o ID) y, si es necesario, una sola combinación.
  • Renovación: semanal, cada dos semanas, mensual, trimestral, semestral o anual, con un multiplicador («mensual cada 2» = cada 2 meses).
  • Descuento de suscripción (%): se aplica a cada entrega, después de sus promociones de catálogo.
  • Cuota de alta (sin IVA): se factura una sola vez con el 1.er pedido.
  • Prueba gratuita (días): la 1.ª entrega es gratuita y el 1.er cobro se realiza al final de la prueba.
  • Permanencia: número de entregas pagadas antes de poder cancelar.
  • Número total de entregas: 0 = hasta la cancelación; en caso contrario, la suscripción finaliza por sí sola (p. ej., 12 números).
  • Visualización: nombre y descripción breve por idioma, «Más popular», orden, activación.

La vista previa de la derecha muestra la tarjeta del plan tal como aparecerá. Un plan utilizado por suscripciones no se puede eliminar: desactívelo (las suscripciones en curso continúan).

Editor de planes: frecuencia, descuento, prueba gratuita, cuota de alta, permanencia y vista previa
Editor de planes: frecuencia, descuento, prueba gratuita, cuota de alta, permanencia y vista previa
Lista de planes de suscripción con descuento, prueba, cuota, permanencia y suscriptores
Lista de planes de suscripción con descuento, prueba, cuota, permanencia y suscriptores

Recorrido del cliente

Ficha de producto

El bloque «Opciones de compra» compara la compra única y cada plan: precio tachado, precio por entrega, ahorro por entrega y por año, distintivos (prueba, permanencia, cuota), mención del 1.er pedido. La elección se guarda incluso antes de añadir por primera vez al carrito.

Ficha de producto: compra única o planes de suscripción con ahorro por entrega y por año
Ficha de producto: compra única o planes de suscripción con ahorro por entrega y por año
Opciones de compra en el móvil
Opciones de compra en el móvil

Carrito y pago

El carrito muestra el precio de suscripción y un resumen: plan, prueba, cuota, importe recurrente y fecha de la próxima renovación. En el pago, el cliente ve lo que paga hoy y la autorización de cobro para las renovaciones. Una suscripción requiere una cuenta de cliente: se invita al visitante a iniciar sesión o a crear una cuenta.

Carrito con el precio de suscripción y el resumen de las próximas renovaciones
Carrito con el precio de suscripción y el resumen de las próximas renovaciones
Pago: tarjeta, PayPal o adeudo directo SEPA con mandato electrónico para las renovaciones
Pago: tarjeta, PayPal o adeudo directo SEPA con mandato electrónico para las renovaciones
Confirmación de pedido con la suscripción activada y su próxima renovación
Confirmación de pedido con la suscripción activada y su próxima renovación

Adeudos directos SEPA (fichero bancario)

Los pedidos pagados mediante orden de domiciliación SEPA esperan en Suscripciones → Adeudos directos SEPA:

  1. seleccione los cobros, elija la fecha de cobro (respetando el plazo de su banco) y haga clic en Crear el fichero de adeudos;
  2. descargue el fichero XML pain.008 y súbalo a su banca en línea (los primeros adeudos FRST y los adeudos recurrentes RCUR se agrupan automáticamente);
  3. cuando el banco haya pagado, haga clic en Marcar como pagado: los pedidos pasan a «Pago aceptado», la suscripción comienza o la renovación se contabiliza;
  4. un adeudo devuelto se marca como «rechazado»: el pedido pasa a «Error en el pago» y la suscripción sigue sus reglas de reintento.

Los IBAN se guardan cifrados; solo se muestran el país y los 4 últimos dígitos. El fichero se regenera en cada descarga.

Adeudos directos SEPA: cobros por exportar, ficheros pain.008 para el banco, adeudos pagados o rechazados
Adeudos directos SEPA: cobros por exportar, ficheros pain.008 para el banco, adeudos pagados o rechazados

Renovaciones y programador

El programador procesa las renovaciones vencidas, reintenta los pagos fallidos, reanuda las suscripciones cuya pausa ha terminado, hace el seguimiento de los pedidos offline impagados y de los adeudos directos SEPA en curso, y envía los recordatorios. Ejecútelo una vez al día (o cada hora). Por línea de comandos (recomendado; el token también puede pasarse mediante la variable DFSUBSCRIPTION_CRON_TOKEN):

0 6 * * * php /ruta/de/la/tienda/modules/dfsubscription/cli/run.php --token=SU_TOKEN

o por URL: https://sutienda.es/module/dfsubscription/cron?token=SU_TOKEN. Códigos de salida de la línea de comandos: 0 = OK, 2 = token no válido, 3 = módulo desactivado, 5 = fallos de pago o errores. El panel «Programador» de la configuración muestra la última ejecución y permite lanzar una ejecución o regenerar el token.

En cada renovación: carrito reconstruido en la tienda, la moneda, el idioma y con la dirección de la suscripción, transportista original si está disponible, precio de suscripción (precio actual menos el descuento, o precio bloqueado según su configuración), cobro y, a continuación, pedido estándar de PrestaShop y e-mail al cliente. Si el producto está agotado o no disponible, la renovación se aplaza un día sin cobro ni fallo contabilizado, y usted recibe un aviso.

Pagos fallidos y reintentos

  1. El cobro falla: la suscripción pasa a «Pago fallido» y el cliente recibe un e-mail con un enlace para actualizar su método de pago. En el caso de un adeudo directo SEPA, el pedido rechazado pasa a «Error en el pago» y sigue las mismas reglas.
  2. Nuevo intento automático tras el plazo configurado (por defecto, 3 intentos con 3 días de intervalo).
  3. Tras el último intento: suspensión (por defecto) o cancelación, según su configuración; usted recibe un aviso.
  4. En cuanto el cliente guarda un nuevo método de pago, la suscripción vuelve a estar activa y se cobra en la siguiente ejecución.
Correo de pago fallido con el próximo intento y el enlace para actualizar el método de pago
Correo de pago fallido con el próximo intento y el enlace para actualizar el método de pago

Área de cliente «Mis suscripciones»

El cliente ve sus suscripciones en curso y pasadas y, para cada una: estado, próxima fecha, método de pago, permanencia restante, entregas, pedidos e historial. Según su configuración, puede:

  • Saltar la próxima entrega.
  • Pausar durante 1 a N entregas (reanudación automática) o hasta su reanudación y, después, reanudar en la fecha prevista.
  • Cambiar de plan entre los del producto (con efecto en la próxima renovación, sin prorrateo) y cambiar la cantidad.
  • Cambiar la dirección de entrega y sustituir su método de pago: nueva tarjeta, nuevo IBAN, nueva orden de domiciliación SEPA u otra cuenta PayPal (se aplica a todas sus suscripciones pagadas del mismo modo).
  • Cancelar indicando un motivo; durante una permanencia, solo puede programar la cancelación al final de la permanencia (y anularla).

Cada acción se envía por POST con un token de sesión y comprueba que la suscripción pertenece efectivamente al cliente.

Área de cliente: mis suscripciones con estado y próxima renovación
Área de cliente: mis suscripciones con estado y próxima renovación
Autogestión: saltar una entrega, pausa, cambio de plan, cantidad, método de pago, historial
Autogestión: saltar una entrega, pausa, cambio de plan, cantidad, método de pago, historial

Back-office

Panel

Ingresos recurrentes mensuales estimados (sin IVA), suscriptores activos, pruebas en curso, tasa de bajas a 30 días, pagos fallidos que requieren seguimiento, renovaciones a 7 y 30 días, volumen de negocio de los pedidos de suscripción, ingresos por suscriptor, gráfico de 12 meses, nuevas suscripciones y cancelaciones, distribución por estado, mejores planes, próximas renovaciones, actividad reciente y motivos de cancelación. Se muestra una guía de inicio mientras la configuración no esté terminada.

Panel de suscripciones: ingresos recurrentes mensuales, suscriptores activos, bajas, pruebas y pagos fallidos
Panel de suscripciones: ingresos recurrentes mensuales, suscriptores activos, bajas, pruebas y pagos fallidos

Suscriptores y ficha del suscriptor

La lista se filtra por estado (activas, prueba, en pausa, pago fallido, pendiente de pago, finalizadas), se exporta en CSV y admite acciones masivas (pausa, reanudación, cancelación). La ficha de una suscripción reúne indicadores, acciones (cobrar o facturar ahora, saltar, pausa, reanudación, fecha de la próxima renovación, plan, cantidad, cancelación, reactivación), pedidos y cronología completa.

Lista de suscriptores con filtros por estado, importes y próximas renovaciones
Lista de suscriptores con filtros por estado, importes y próximas renovaciones
Ficha de una suscripción en el back office: indicadores, acciones, pedidos e historial
Ficha de una suscripción en el back office: indicadores, acciones, pedidos e historial

Otras pantallas

  • Actividad: todos los eventos, filtrables por tipo y por autor (cliente, empleado, programador).
  • Ficha de pedido y ficha de cliente: panel de las suscripciones vinculadas.
  • Grupo de clientes «suscriptores» (Configuración): los clientes forman parte de él mientras tengan una suscripción activa o en pausa; utilícelo para precios reservados o para el acceso a categorías.

E-mails

Todos los e-mails se envían en el idioma del cliente (8 idiomas incluidos) con los importes en su moneda: suscripción confirmada, renovación pagada, adeudo directo SEPA solicitado, pedido pendiente de pago y recordatorios, pago fallido, recordatorio antes de la renovación y del final de la prueba, pausa, reanudación, modificación, cancelación, final próximo. El comerciante recibe las nuevas suscripciones, las cancelaciones, las suspensiones y las renovaciones aplazadas. Los textos se modifican en Internacional → Traducciones → Traducciones de módulos.

Correo de confirmación de la suscripción en el idioma del cliente
Correo de confirmación de la suscripción en el idioma del cliente
Correo de recordatorio antes de la próxima renovación
Correo de recordatorio antes de la próxima renovación

Preguntas frecuentes y solución de problemas

El bloque de suscripción no aparece en la ficha de producto

Compruebe que existe un plan activo para este producto (o esta combinación) y que al menos un método de pago está «Listo» en la configuración (claves de Stripe o PayPal introducidas, datos del acreedor SEPA completos; carrito en euros para SEPA).

PayPal rechaza las renovaciones

Compruebe con PayPal que su cuenta está autorizada para los pagos guardados (Vault, pagos iniciados por el comerciante). El error devuelto por PayPal aparece en el historial de la suscripción.

Las renovaciones no se realizan

El panel «Programador» indica la última ejecución. Ejecute el comando manualmente para ver el informe y los posibles errores.

¿Cómo hacer pruebas sin riesgo?

Active el Modo de prueba, cree un plan, haga un pedido con la tarjeta 4242 4242 4242 4242 y, a continuación, utilice «Cobrar ahora» en la ficha de la suscripción. La tarjeta 4000 0000 0000 0341 se acepta en el pedido y después se rechaza en la renovación: ideal para probar los reintentos.

¿Necesita ayuda? Abra un ticket desde su cuenta DataFirefly: respuesta en 24 horas laborables, en francés o en inglés.

¿Te ha resultado útil esta página?

¿Sigues atascado? Contacta con soporte