PS PrestaShop Intermédiaire

DataFirefly Subscriptions — Guide complet (PrestaShop 8 & 9)

Installation, moyens de paiement (carte, prélèvement SEPA, PayPal, facturation hors ligne), formules, planificateur, relances, espace client et back-office du module d'abonnements pour PrestaShop 8 et 9.

Mis à jour Version du module 3.0.0

Présentation

DataFirefly Subscriptions vend vos produits en abonnement sur PrestaShop 8 et 9. Vous créez des formules (fréquence, remise, essai gratuit, frais d’inscription, engagement, nombre de livraisons) ; le client choisit sa formule sur la fiche produit, paie sa première commande, puis chaque échéance crée automatiquement une vraie commande PrestaShop, payée automatiquement par le moyen de paiement qu’il a enregistré (carte, prélèvement SEPA ou PayPal) ou envoyée en attente de paiement (facturation hors ligne).

  • Prix d’abonnement visible partout : remise, essai gratuit et frais d’inscription sont appliqués au panier, au paiement, sur la commande et la facture.
  • Un seul moteur de facturation : le planificateur de la boutique ; chaque abonnement est réservé avant son renouvellement, deux passages simultanés ne débitent jamais deux fois.
  • Le client gère tout depuis son compte : sauter une livraison, pause, changement de formule, quantité, adresse, moyen de paiement, résiliation.
  • Back-office complet : tableau de bord, liste des abonnés, fiche avec chronologie, éditeur de formules avec aperçu.

Nouveautés 3.0.0 : prélèvement SEPA (via Stripe ou par fichier bancaire pain.008) et PayPal, facturation hors ligne et mode test, frais d’inscription, essai réellement gratuit, remise appliquée dès la 1re commande, pause avec reprise automatique, changement de formule et de quantité par le client, changement de moyen de paiement, résiliation en fin d’engagement, rappel avant renouvellement, groupe client « abonnés », nouveau tableau de bord, e-mails dans 8 langues, cron en ligne de commande.

Abonnement ou commande récurrente ? DataFirefly Subscriptions crée les commandes à l’échéance et les fait payer automatiquement (ou les facture). Si vous préférez envoyer au client un panier prêt à régler avant chaque échéance, sans prélèvement, voyez plutôt le module DF Recurring Orders.

Installation et mise à jour

  1. Téléchargez le ZIP depuis votre compte DataFirefly.
  2. Back-office : Modules → Gestionnaire de modules → Installer un module, choisissez le ZIP.
  3. Le menu Commandes → Abonnements apparaît : Tableau de bord, Abonnés, Formules, Activité, Paramètres, Prélèvements SEPA.

Prérequis : PrestaShop 8.0 à 9.x, PHP 7.4 à 8.5, une tâche planifiée (cron) chez votre hébergeur ; selon les moyens choisis : un compte Stripe (carte, prélèvement SEPA via Stripe), un compte PayPal Business éligible au coffre PayPal (paiements initiés par le marchand), ou un identifiant créancier SEPA (ICS) et une banque acceptant les fichiers de prélèvement pain.008. Aucune dépendance Composer.

Mise à jour depuis la 2.x : installez le ZIP 3.0.0 par-dessus. La migration ajoute les nouvelles colonnes, répare les dates vides enregistrées par la 2.x, reprend la boutique, la devise et la langue de chaque abonnement, conserve vos réglages (une boutique 2.x en Stripe garde la carte comme moyen de paiement) et supprime les fichiers devenus inutiles. Aucun abonnement n’est perdu.

À la désinstallation, les abonnements sont conservés par défaut et retrouvés après réinstallation ; l’option « Supprimer les données à la désinstallation » efface tout.

Choisir les moyens de paiement

Abonnements → Paramètres → Paiement propose deux modes :

  • Moyen de paiement enregistré : renouvellements automatiques — vous cochez les moyens proposés au paiement ; le client en choisit un, il est enregistré à la 1re commande puis utilisé automatiquement à chaque renouvellement. Pour un panier contenant un abonnement, seuls ces moyens sont proposés.
  • Facturation hors ligne — la 1re commande se paie avec n’importe lequel de vos moyens de paiement (virement, chèque…). L’abonnement démarre quand la commande passe à un état payé. Chaque renouvellement crée une commande « en attente de paiement » (par défaut « En attente du paiement par virement bancaire », qui envoie vos coordonnées bancaires) ; le client est relancé et l’abonnement est suspendu si la commande reste impayée.

Moyens disponibles en mode « moyen de paiement enregistré » (chaque carte indique « Prêt » ou « À configurer ») :

  • Carte (Stripe) — carte enregistrée avec 3-D Secure, débitée à chaque renouvellement.
  • Prélèvement SEPA (Stripe) — l’IBAN est saisi dans le formulaire sécurisé de Stripe, qui gère le mandat. Un prélèvement est confirmé par la banque après quelques jours : la commande reste « En attente de prélèvement SEPA » et passe à « Paiement accepté » quand Stripe confirme ; le planificateur vérifie le résultat, aucun webhook supplémentaire n’est nécessaire.
  • PayPal — le client approuve une fois dans PayPal ; son compte est enregistré dans le coffre PayPal et les renouvellements sont débités sans nouvelle approbation. Créez une application REST dans l’espace développeur PayPal (identifiants sandbox puis production) ; votre compte PayPal Business doit être autorisé aux paiements enregistrés (« Vault »).
  • Prélèvement SEPA (fichier bancaire) — le client signe un mandat SEPA sur votre boutique (titulaire, IBAN vérifié, BIC facultatif, case de signature). Vous transmettez vous-même les prélèvements à votre banque : voir « Prélèvements SEPA » ci-dessous. Renseignez le nom du créancier, votre identifiant créancier SEPA (ICS), l’IBAN et le BIC du compte crédité.
  • Mode test — cartes simulées (numéros de test Stripe), aucun paiement réel : pour répéter tout le cycle avant la mise en production.

Les prélèvements SEPA ne sont proposés que pour les paniers en euros.

Paramètres : carte, prélèvement SEPA et PayPal pour les renouvellements automatiques, ou facturation hors ligne
Paramètres : carte, prélèvement SEPA et PayPal pour les renouvellements automatiques, ou facturation hors ligne

Clés et webhook Stripe

Renseignez les clés publiques et secrètes du mode choisi (test ou live) ; les clés secrètes enregistrées ne sont jamais réaffichées (laisser le champ vide conserve la clé). Créez ensuite un webhook dans Stripe vers l’URL affichée, avec les événements payment_method.detached, charge.refunded et charge.dispute.created, puis collez le secret de signature whsec_…. Les événements non signés sont refusés et chaque événement n’est traité qu’une fois.

Créer une formule

Abonnements → Formules → Nouvelle formule (ou depuis l’onglet Modules de la fiche produit) :

  • Produit (recherche par nom, référence ou ID) et, si besoin, une seule déclinaison.
  • Renouvellement : hebdomadaire, toutes les deux semaines, mensuel, trimestriel, semestriel ou annuel, avec un multiplicateur (« mensuel tous les 2 » = tous les 2 mois).
  • Remise abonnement (%) : appliquée à chaque livraison, après vos promotions catalogue.
  • Frais d’inscription (HT) : facturés une fois avec la 1re commande.
  • Essai gratuit (jours) : la 1re livraison est gratuite, le 1er débit a lieu à la fin de l’essai.
  • Engagement : nombre de livraisons payées avant de pouvoir résilier.
  • Nombre total de livraisons : 0 = jusqu’à résiliation ; sinon l’abonnement se termine seul (ex. 12 numéros).
  • Affichage : nom et accroche par langue, « La plus populaire », ordre, activation.

L’aperçu à droite montre la carte de formule telle qu’elle apparaîtra. Une formule utilisée par des abonnements ne peut pas être supprimée : désactivez-la (les abonnements en cours continuent).

Éditeur de formule : fréquence, remise, essai gratuit, frais d'inscription, engagement et aperçu en direct
Éditeur de formule : fréquence, remise, essai gratuit, frais d’inscription, engagement et aperçu en direct
Liste des formules d'abonnement avec remise, essai, frais, engagement et abonnés
Liste des formules d’abonnement avec remise, essai, frais, engagement et abonnés

Parcours client

Fiche produit

Le bloc « Options d’achat » compare l’achat unique et chaque formule : prix barré, prix par livraison, économie par livraison et par an, badges (essai, engagement, frais), mention de la 1re commande. Le choix est enregistré même avant le premier ajout au panier.

Fiche produit : achat unique ou formules d'abonnement avec économie par livraison et par an
Fiche produit : achat unique ou formules d’abonnement avec économie par livraison et par an
Options d'achat sur mobile
Options d’achat sur mobile

Panier et paiement

Le panier affiche le prix d’abonnement et un récapitulatif : formule, essai, frais, montant récurrent et date du prochain renouvellement. Au paiement, le client voit ce qui est payé aujourd’hui et l’autorisation de débit pour les renouvellements. Un abonnement nécessite un compte client : un invité est invité à se connecter ou à créer un compte.

Panier au prix de l'abonnement avec le récapitulatif des prochains renouvellements
Panier au prix de l’abonnement avec le récapitulatif des prochains renouvellements
Paiement : carte, PayPal ou prélèvement SEPA avec mandat électronique pour les renouvellements
Paiement : carte, PayPal ou prélèvement SEPA avec mandat électronique pour les renouvellements
Confirmation de commande avec l'abonnement en place et son prochain renouvellement
Confirmation de commande avec l’abonnement en place et son prochain renouvellement

Prélèvements SEPA (fichier bancaire)

Les commandes payées par mandat SEPA attendent dans Abonnements → Prélèvements SEPA :

  1. sélectionnez les encaissements, choisissez la date d’encaissement (en respectant le délai de votre banque) et cliquez sur Créer le fichier de prélèvement ;
  2. téléchargez le fichier XML pain.008 et déposez-le dans votre banque en ligne (1ers prélèvements FRST et prélèvements récurrents RCUR sont regroupés automatiquement) ;
  3. quand la banque a payé, cliquez sur Marquer comme payé : les commandes passent à « Paiement accepté », l’abonnement démarre ou le renouvellement est compté ;
  4. un prélèvement rejeté se marque « rejeté » : la commande passe en « Erreur de paiement » et l’abonnement suit vos règles de relance.

Les IBAN sont enregistrés chiffrés ; seuls le pays et les 4 derniers chiffres sont affichés. Le fichier est régénéré à chaque téléchargement.

Prélèvements SEPA : encaissements à exporter, fichiers pain.008 pour la banque, prélèvements payés ou rejetés
Prélèvements SEPA : encaissements à exporter, fichiers pain.008 pour la banque, prélèvements payés ou rejetés

Renouvellements et planificateur

Le planificateur traite les renouvellements dus, relance les paiements échoués, reprend les abonnements dont la pause est terminée, suit les commandes hors ligne impayées et les prélèvements SEPA en cours, et envoie les rappels. Lancez-le une fois par jour (ou toutes les heures). En ligne de commande (recommandé, le jeton peut aussi être passé par la variable DFSUBSCRIPTION_CRON_TOKEN) :

0 6 * * * php /chemin/de/la/boutique/modules/dfsubscription/cli/run.php --token=VOTRE_JETON

ou par URL : https://votreboutique.fr/module/dfsubscription/cron?token=VOTRE_JETON. Codes de sortie de la ligne de commande : 0 = OK, 2 = jeton invalide, 3 = module désactivé, 5 = échecs de paiement ou erreurs. Le panneau « Planificateur » des paramètres affiche le dernier passage et permet de lancer un passage ou de régénérer le jeton.

À chaque renouvellement : panier reconstruit dans la boutique, la devise, la langue et à l’adresse de l’abonnement, transporteur d’origine s’il est disponible, prix d’abonnement (prix courant moins la remise, ou prix verrouillé selon vos réglages), débit puis commande PrestaShop standard et e-mail au client. Si le produit est en rupture ou indisponible, le renouvellement est reporté d’un jour sans débit ni échec compté, et vous êtes prévenu.

Échecs de paiement et relances

  1. Le débit échoue : l’abonnement passe « Paiement échoué », le client reçoit un e-mail avec un lien pour mettre à jour son moyen de paiement. Pour un prélèvement SEPA, la commande rejetée passe en « Erreur de paiement » et suit les mêmes règles.
  2. Nouvelle tentative automatique après le délai réglé (3 tentatives à 3 jours d’intervalle par défaut).
  3. Après la dernière tentative : suspension (par défaut) ou résiliation, selon vos réglages ; vous êtes prévenu.
  4. Dès que le client enregistre un nouveau moyen de paiement, l’abonnement redevient actif et il est débité au passage suivant.
E-mail de paiement échoué avec la prochaine tentative et le lien de mise à jour du moyen de paiement
E-mail de paiement échoué avec la prochaine tentative et le lien de mise à jour du moyen de paiement

Espace client « Mes abonnements »

Le client voit ses abonnements en cours et passés, puis, pour chacun : statut, prochaine date, moyen de paiement, engagement restant, livraisons, commandes et historique. Selon vos réglages, il peut :

  • Sauter la prochaine livraison.
  • Mettre en pause pour 1 à N livraisons (reprise automatique) ou jusqu’à reprise, puis reprendre à la date prévue.
  • Changer de formule parmi celles du produit (effet au prochain renouvellement, sans prorata) et changer la quantité.
  • Changer l’adresse de livraison et remplacer son moyen de paiement : nouvelle carte, nouvel IBAN, nouveau mandat SEPA ou autre compte PayPal (appliqué à tous ses abonnements payés de la même façon).
  • Résilier avec un motif ; pendant un engagement, il peut seulement programmer la résiliation à la fin de l’engagement (et l’annuler).

Chaque action est envoyée en POST avec un jeton de session et vérifie que l’abonnement appartient bien au client.

Espace client : mes abonnements avec statut et prochain renouvellement
Espace client : mes abonnements avec statut et prochain renouvellement
Gestion par le client : sauter une livraison, pause, changement de formule, quantité, moyen de paiement, historique
Gestion par le client : sauter une livraison, pause, changement de formule, quantité, moyen de paiement, historique

Back-office

Tableau de bord

Revenu mensuel récurrent estimé (HT), abonnés actifs, essais en cours, taux de résiliation sur 30 jours, paiements échoués à suivre, renouvellements à 7 et 30 jours, chiffre d’affaires des commandes d’abonnement, revenu par abonné, graphique sur 12 mois, nouveaux abonnements et résiliations, répartition par statut, meilleures formules, prochains renouvellements, activité récente et motifs de résiliation. Un guide de démarrage s’affiche tant que la configuration n’est pas terminée.

Tableau de bord des abonnements : revenu mensuel récurrent, abonnés actifs, résiliations, essais et paiements échoués
Tableau de bord des abonnements : revenu mensuel récurrent, abonnés actifs, résiliations, essais et paiements échoués

Abonnés et fiche abonné

La liste se filtre par statut (actifs, essai, en pause, paiement échoué, en attente de paiement, terminés), s’exporte en CSV et accepte des actions groupées (pause, reprise, résiliation). La fiche d’un abonnement réunit indicateurs, actions (débiter ou facturer maintenant, sauter, pause, reprise, date du prochain renouvellement, formule, quantité, résiliation, réactivation), commandes et chronologie complète.

Liste des abonnés avec filtres par statut, montants et prochains renouvellements
Liste des abonnés avec filtres par statut, montants et prochains renouvellements
Fiche d'un abonnement dans le back-office : indicateurs, actions, commandes et chronologie
Fiche d’un abonnement dans le back-office : indicateurs, actions, commandes et chronologie

Autres écrans

  • Activité : tous les événements, filtrables par type et par auteur (client, employé, planificateur).
  • Fiche commande et fiche client : panneau des abonnements liés.
  • Groupe client « abonnés » (Paramètres) : les clients y entrent tant qu’un abonnement est actif ou en pause ; utilisez-le pour des prix réservés ou l’accès à des catégories.

E-mails

Tous les e-mails partent dans la langue du client (8 langues fournies) avec les montants dans sa devise : abonnement confirmé, renouvellement payé, prélèvement SEPA demandé, commande en attente de paiement et relances, paiement échoué, rappel avant renouvellement et fin d’essai, pause, reprise, modification, résiliation, fin approchant. Le marchand reçoit les nouveaux abonnements, les résiliations, les suspensions et les renouvellements reportés. Les textes se modifient dans International → Traductions → Traductions des modules.

E-mail de confirmation d'abonnement dans la langue du client
E-mail de confirmation d’abonnement dans la langue du client
E-mail de rappel avant le prochain renouvellement
E-mail de rappel avant le prochain renouvellement

Questions fréquentes et dépannage

Le bloc d’abonnement n’apparaît pas sur la fiche produit

Vérifiez qu’une formule active existe pour ce produit (ou cette déclinaison) et qu’au moins un moyen de paiement est « Prêt » dans les paramètres (clés Stripe ou PayPal renseignées, coordonnées du créancier SEPA complètes ; panier en euros pour le SEPA).

PayPal refuse les renouvellements

Vérifiez auprès de PayPal que votre compte est autorisé aux paiements enregistrés (Vault, paiements initiés par le marchand). L’erreur renvoyée par PayPal apparaît dans l’historique de l’abonnement.

Les renouvellements ne se font pas

Le panneau « Planificateur » indique le dernier passage. Lancez la commande à la main pour voir le compte rendu et les erreurs éventuelles.

Comment tester sans risque ?

Passez en Mode test, créez une formule, commandez avec la carte 4242 4242 4242 4242, puis utilisez « Débiter maintenant » sur la fiche de l’abonnement. La carte 4000 0000 0000 0341 est acceptée à la commande puis refusée au renouvellement : idéale pour tester les relances.

Besoin d’aide ? Ouvrez un ticket depuis votre compte DataFirefly : réponse sous 24 h ouvrées, en français ou en anglais.

Cette page vous a-t-elle été utile ?

Toujours bloqué ? Contactez le support