Cartes cadeaux – manuel d’utilisation du module PrestaShop

1. À quoi sert le module

Cartes cadeaux vous permet de vendre des cartes cadeaux dans votre boutique PrestaShop sans second système de codes à côté de celui que vous avez déjà. Vous choisissez les produits qui sont des cartes cadeaux. Dès qu’une commande contenant un tel produit est payée, chaque unité achetée devient un bon de réduction natif de PrestaShop, d’une valeur égale au prix du produit. Une carte numérique arrive chez l’acheteur par e-mail, en PDF prêt à imprimer ou à transférer ; une carte physique est imprimée par vos soins depuis la page de la commande et expédiée dans le colis. Le porteur paie avec la carte en saisissant son code dans le panier, comme n’importe quel bon de réduction, et PrestaShop gère lui-même l’utilisation partielle, la date de validité et les devises.

Fonctionne avec PrestaShop 1.7.8, 8.x et 9.x (PHP 7.2.5 ou plus récent), avec les thèmes Classic et Hummingbird et en multiboutique.

2. Installation

1. Téléchargez ap_giftcard_v1.0.0.zip depuis Mon compte → Historique des commandes sur addonspresta.com.
2. Dans votre back-office, ouvrez Modules → Gestionnaire de modules et cliquez sur Installer un module.
3. Déposez le fichier zip et attendez la confirmation.
4. Cliquez sur Configurer, vérifiez les statuts de commande, la validité et le texte sur l’utilisation de la carte, puis enregistrez.
5. Dans la section Produits cartes cadeaux de la même page, cherchez les produits que vous vendez comme cartes cadeaux et ajoutez-les.

Juste après l’installation, le module émet les cartes aux statuts Paiement accepté et Paiement à distance accepté, valables 365 jours, avec des codes qui commencent par GC. Rien n’est émis tant que vous n’avez pas ajouté le premier produit carte cadeau.

3. Fonctionnement

Produit carte cadeau. Une carte cadeau est un produit ordinaire de votre catalogue que vous avez ajouté à la liste de la page de configuration. Son prix est la valeur de la carte. Le stock, les images, les catégories, les déclinaisons et les champs de personnalisation restent des réglages normaux du produit : une carte proposée en plusieurs montants ou en plusieurs visuels est simplement un produit avec des déclinaisons.

Numérique ou physique. Le type du produit décide. Un produit virtuel est une carte numérique : une commande qui ne contient que des produits virtuels ne demande aucune livraison, et l’acheteur reçoit la carte par e-mail. Tout autre produit est une carte physique : la commande suit la livraison habituelle, vous imprimez la carte et vous la glissez dans le colis.

Émission. Dès qu’une commande reçoit l’un des statuts que vous avez choisis, chaque unité achetée d’un produit carte cadeau devient une carte : trois unités d’une carte de 100 € donnent trois cartes avec trois codes, et chacune peut être offerte à une personne différente. Une unité ne reçoit jamais de seconde carte, quoi qu’il arrive ensuite à la commande. Le code ressemble à GC-7KQM-X2RD-9HTP : votre préfixe et douze caractères aléatoires, sans caractères faciles à confondre comme 0 et O.

Valeur. Une carte vaut le prix du produit, ou de la déclinaison achetée, taxes comprises, dans la devise de la commande. Les réductions appliquées à l’achat ne la diminuent pas : une carte de 100 € achetée pendant une promotion de −20 % ou avec un bon de réduction vaut toujours 100 €. Deux réglages de prix la diminuent, car ils remplacent le prix lui-même : un prix spécifique avec un prix fixe et une réduction du groupe de clients.

Une exception empêche de multiplier une promotion : lorsqu’une commande est payée, même en partie, avec une carte cadeau, chaque carte achetée dans cette commande vaut ce qui a réellement été payé pour elle — son prix après réductions, moins sa part des autres bons de réduction de la commande — et jamais plus que le prix du produit. Une carte de 100 € en promotion à 80 € et payée avec une autre carte cadeau vaut 80 €.

La carte comme bon de réduction. Chaque carte est une règle panier dans Catalogue → Réductions, nommée « Carte cadeau » : un montant taxes comprises, valable jusqu’à la fin du dernier jour de validité, utilisable une fois, avec utilisation partielle, pour toute personne qui connaît le code — connectée ou invitée. En multiboutique, elle fonctionne uniquement dans la boutique de la commande.

E-mail. Pour les cartes numériques, l’acheteur reçoit un seul e-mail avec un fichier PDF distinct pour chaque carte : chacune peut être transférée séparément. L’e-mail part à l’adresse de la commande, commandes d’invités comprises, dans la langue de la commande (anglais, polonais ou français ; anglais pour toute autre langue). Les cartes physiques n’envoient aucun e-mail.

Carte PDF. Une page A4 avec le logo de votre boutique, l’image du produit ou de la déclinaison achetée, la valeur, le code, la date d’expiration, la dédicace et votre texte sur l’utilisation de la carte. La dédicace reprend tout ce que l’acheteur a saisi dans les champs de personnalisation de type texte du produit, comme « Pour », « De » et « Message ».

Payer avec une carte. Le porteur saisit le code dans le champ des bons de réduction du panier. La carte paie les produits ; si les produits coûtent moins que la carte, PrestaShop crée un nouveau code pour le montant restant et l’envoie par e-mail au client qui a passé la commande. Le module enregistre quels codes appartiennent à quelle carte et vous montre le solde.

Le module ne se connecte ni à addonspresta.com ni à aucun autre serveur, ne dépose aucun cookie et ne conserve aucun fichier PDF : les cartes sont générées au moment où quelqu’un les demande.

4. Fonctions et réglages

Ouvrez Modules → Gestionnaire de modules → Cartes cadeaux → Configurer. La page affiche le bloc Aide, les réglages, les produits cartes cadeaux et un bref rappel du comportement des bons de réduction de PrestaShop.

Réglages

Activer les cartes cadeaux. Une fois l’option désactivée, aucune nouvelle carte n’est émise, de quelque manière que ce soit, et les informations sur la carte cadeau disparaissent de la boutique, de même que le téléchargement du PDF. Les cartes déjà émises restent valables et vous pouvez toujours les gérer.

Statuts de commande qui émettent les cartes cadeaux. Les cartes d’une commande sont émises la première fois qu’elle reçoit l’un des statuts cochés. Au moins un statut doit rester coché. Tenez-vous aux statuts qui signifient que l’argent est arrivé ; ajoutez vos propres statuts de commande payée, ceux d’un module de paiement notamment, si vous en utilisez.

Validité (jours à compter de la date d’émission). De 1 à 3650 jours, 365 à l’origine. Une modification concerne les cartes émises à partir de ce moment ; les cartes émises plus tôt gardent leur date.

Préfixe du code. Jusqu’à 8 lettres majuscules et chiffres placés au début de chaque code, GC à l’origine. Il peut rester vide.

Afficher les informations sur la carte cadeau sur la page produit. Un court bloc sur la page d’un produit carte cadeau : comment la carte est remise et combien de temps elle est valable.

Envoyer une copie des e-mails de cartes cadeaux à. Adresse facultative qui reçoit une copie cachée de chaque e-mail de cartes cadeaux, fichiers PDF compris.

Comment utiliser la carte (PDF et e-mail). Texte simple pour chaque langue, jusqu’à 1000 caractères, imprimé sur le PDF et repris dans l’e-mail. {shop_name} et {shop_url} sont remplacés par le nom et l’adresse de la boutique. Une langue laissée vide reprend le texte de la langue principale de la boutique.

Produits cartes cadeaux

Saisissez au moins trois caractères du nom ou de la référence d’un produit, ou son ID, choisissez le produit parmi les résultats et cliquez sur Ajouter. Un employé qui n’a pas accès à Commandes → Cartes cadeaux ajoute un produit en saisissant son ID. Les packs ne peuvent pas être des cartes cadeaux.

La liste montre chaque produit carte cadeau avec son type — Numérique — PDF par e-mail ou Physique — expédiée — et la valeur de la carte : les prix, taxes comprises, du produit ou de ses déclinaisons. Retirer arrête la vente du produit comme carte cadeau ; les cartes déjà émises restent valables.

Deux remarques peuvent apparaître en dessous d’un produit. Un produit avec une règle de taxe : la carte vaut le prix taxes comprises. Les cartes cadeaux sont en général vendues hors taxe, car la taxe est payée au moment où la carte est dépensée ; demandez à votre comptable et réglez la règle de taxe du produit en conséquence. Un produit virtuel avec un fichier à télécharger : le client reçoit également l’e-mail de téléchargement de PrestaShop avec le lien de ce fichier, laissez donc le fichier vide.

Si vous ajoutez le premier produit virtuel alors que la fonction des produits virtuels de la boutique est désactivée, le module l’active ; autrement, un panier contenant uniquement une carte numérique demanderait encore une livraison.

Bon à savoir concernant les cartes numériques : un produit virtuel suit lui aussi les règles de stock. Donnez-lui une grande quantité ou autorisez les commandes en rupture de stock ; autrement, il cesse d’être vendu quand le stock tombe à zéro. Si vous souhaitez une dédicace sur la carte, ajoutez au produit des champs de personnalisation de type texte depuis sa fiche.

Images d’exemple. Le module contient trois images de cartes cadeaux prêtes à l’emploi, 800 × 800 px, avec des textes en anglais : gift-card-digital-50.jpg, gift-card-digital-100.jpg et gift-card-envelope.jpg, dans le dossier views/img/samples/ du module (dans le zip téléchargé et dans modules/ap_giftcard/ de votre boutique). Ajoutez-les comme images du produit depuis sa fiche, ou partez d’elles pour créer votre propre visuel. Le module lui-même ne les utilise pas : la carte montre toujours l’image du produit.

Page de la commande

Les commandes contenant des cartes cadeaux reçoivent une section Cartes cadeaux sur la page de la commande : produit, type, code, valeur, solde, statut et date de l’e-mail de chaque carte.

• PDF affiche une carte ; Imprimer toutes les cartes (PDF) réunit toutes les cartes de la commande en un seul fichier, une carte sur chaque page. C’est ainsi que vous préparez les cartes physiques : impression, colis, expédition.
• Émettre maintenant apparaît si la commande contient des unités qui n’ont pas de carte, à la suite d’une augmentation de quantité notamment, ou si vous souhaitez émettre les cartes d’une commande payée d’une autre manière. L’action fonctionne quel que soit le statut de la commande.
• Renvoyer l’e-mail envoie de nouveau l’e-mail de la carte numérique. « Non envoyé » dans la colonne e-mail signifie que la boutique n’a pas réussi à envoyer le message ; vérifiez les réglages d’e-mail de la boutique et renvoyez-le.
• Si la commande est annulée ou remboursée alors que ses cartes sont encore valables, la section affiche un avertissement. Le module n’annule jamais une carte de lui-même : cliquez sur Désactiver si la carte ne doit pas être utilisée.
• Si une carte cadeau qui a payé la commande a aussi été utilisée pour une autre commande, aucune carte n’est émise automatiquement et la section indique ces commandes. Cela peut arriver lorsque deux commandes sont passées avec le même code au même instant. Vérifiez quelle commande la carte a réellement payée, puis cliquez sur Émettre maintenant si les cartes doivent être émises.
• Lorsqu’un même panier a donné lieu à plusieurs commandes, aucune carte n’est émise automatiquement non plus et la section indique les autres commandes. Cela peut arriver quand le client confirme deux fois la même commande au même moment, ou quand un module de paiement signale deux fois un seul paiement. Gardez une commande, annulez les autres, puis cliquez sur Émettre maintenant dans la commande que vous gardez.

Commandes → Cartes cadeaux

La liste de toutes les cartes émises : code, type, valeur, solde, commande, client, date d’émission, date d’expiration, statut et date de l’e-mail. Vous pouvez filtrer selon le code, le type, la référence de la commande, l’e-mail du client, la date d’émission et le statut, et exporter la liste en CSV. Le filtre du code retrouve également une carte à partir d’un code créé à la suite d’une utilisation partielle.

Statuts : Active (rien n’a été dépensé), Partiellement utilisée, Utilisée, Expirée, Désactivée (désactivée par vos soins) et Bon de réduction supprimé (sa règle panier a été supprimée dans Catalogue → Réductions).

L’action d’affichage de la ligne mène à la page de la carte : le code imprimé sur la carte et le code actuel, la valeur et le solde, les dates, la commande, le client, le produit et la dédicace, puis Codes de cette carte — chaque utilisation partielle remplace le code par un nouveau — et Commandes payées avec cette carte. Désactiver bloque le code actuel tant que vous n’avez pas cliqué sur Réactiver ; le montant n’est pas perdu.

La règle panier d’une carte reste une règle panier ordinaire : vous pouvez prolonger sa date ou la modifier dans Catalogue → Réductions, et la liste affiche aussitôt le nouvel état.

Ce que voit le client

• Page produit : le bloc d’information de la carte, tant que vous le laissez activé.
• Confirmation de commande : une phrase indiquant que la carte sera envoyée par e-mail une fois le paiement reçu, qu’elle a été envoyée, ou qu’elle sera expédiée en même temps que la commande. Aucun code n’y est affiché.
• Détails de la commande dans le compte client et sur la page de suivi de commande des invités : le bloc Cartes cadeaux. Pour une carte numérique, il affiche la valeur, le code, la date d’expiration, le statut et Télécharger le PDF, disponible tant que rien n’a été dépensé de la carte. Pour une carte physique, il affiche uniquement « Expédiée avec votre commande » : le code voyage dans le colis. Sur la page de suivi de commande des invités, le code et le téléchargement n’apparaissent que pour les commandes passées sans compte ; pour la commande d’un client inscrit, la page demande d’abord de se connecter.

Permissions

La page de configuration demande la permission de configurer le module, la section de la page de la commande celle de l’afficher. La liste Commandes → Cartes cadeaux suit les permissions de cette entrée de menu dans Paramètres avancés → Équipe : affichage pour la liste, la page de la carte et le PDF, modification pour l’émission, le renvoi, la désactivation et la réactivation.

5. Multiboutique

Les réglages et les produits cartes cadeaux sont enregistrés pour la boutique sélectionnée dans l’en-tête du back-office : chaque boutique peut vendre d’autres cartes, avec ses propres statuts, sa validité, son préfixe et ses textes, ou garder le module désactivé. Dans le contexte Toutes les boutiques, un produit est ajouté dans chaque boutique à laquelle il appartient. Une carte appartient à la boutique de sa commande et son code fonctionne uniquement dans cette boutique. La liste et la page de la commande affichent uniquement les cartes des boutiques que vous gérez. Une licence couvre toutes les boutiques de l’installation.

6. Désinstallation

Gestionnaire de modules → Cartes cadeaux → Désinstaller supprime les réglages, la liste des produits cartes cadeaux et la liste des cartes émises, avec leurs PDF. Les bons de réduction des cartes émises restent dans Catalogue → Réductions et demeurent valables : c’est de l’argent que vos clients ont payé. Pour suspendre la vente des cartes sans rien perdre, désactivez Activer les cartes cadeaux ou utilisez Désactiver.

7. Questions fréquentes et dépannage

Une commande est payée, mais aucune carte n’a été émise. Vérifiez que le module est activé dans cette boutique, que le produit figure dans la liste des produits cartes cadeaux de cette boutique et que le statut de la commande fait partie des statuts cochés. Cliquez ensuite sur Émettre maintenant sur la page de la commande.

Le client n’a pas reçu l’e-mail. Seules les cartes numériques envoient un e-mail. Regardez la colonne e-mail : si elle indique « Non envoyé », vérifiez les réglages d’e-mail de la boutique et cliquez sur Renvoyer l’e-mail. Le client retrouve également la carte dans les détails de sa commande.

La carte n’a pas payé la livraison. PrestaShop limite un bon de réduction d’un montant fixe aux produits du panier : la livraison est payée à part et n’est pas prélevée de la carte.

Le client a dépensé une partie de la carte et le code ne fonctionne plus. À la suite d’une utilisation partielle, PrestaShop remplace le code par un nouveau pour le montant restant, comme GC-7KQM-X2RD-9HTP-2, et l’envoie par e-mail au client qui a passé la commande. Le nouveau code est lié au compte de ce client. Vous le trouvez sur la page de la carte, comme code actuel.

Aucun code n’a été créé pour le montant restant. PrestaShop n’en crée pas si un panier est divisé en plusieurs commandes, en présence de plusieurs entrepôts notamment. Créez un bon de réduction du montant de la différence dans Catalogue → Réductions. Le module considère tout bon de réduction dont le code est un code de carte cadeau suivi d’un tiret et d’un nombre comme du crédit de cette carte, même un bon créé à la main. Ne donnez pas un tel code à un bon de réduction ordinaire.

Une commande payée avec une carte a été annulée. Comment le client récupère-t-il le montant ? PrestaShop ne le rend pas de lui-même. Ouvrez le code dans Catalogue → Réductions et réactivez-le ou augmentez sa quantité. Il en va de même pour une commande créée avec le statut Erreur de paiement ou Annulé : la carte y est utilisée comme pour toute autre commande.

Un bon de réduction peut-il servir à acheter une carte cadeau, ou une carte cadeau à en acheter une autre ? Oui, le module ne bloque ni l’un ni l’autre. Une carte achetée dans une commande payée avec une carte cadeau vaut ce qui a été payé pour elle (voir Valeur) : une promotion sur les cartes cadeaux ne peut donc pas être transformée en crédit supplémentaire en achetant des cartes avec des cartes. Si un code promotionnel ne doit pas concerner les cartes cadeaux, placez les cartes cadeaux dans une catégorie à part, sélectionnez les catégories visées dans l’onglet Conditions de la règle panier, puis appliquez la réduction aux produits sélectionnés dans son onglet Actions.

La carte vaut moins que le prix catalogue. Le client l’a achetée avec un prix spécifique à prix fixe ou avec une réduction du groupe de clients. Les deux remplacent le prix du produit, et la carte suit le prix.

Le client n’arrive pas à télécharger le PDF. Le téléchargement est proposé pour une carte numérique encore active, à son acheteur : connecté, ou depuis la page de suivi de commande des invités lorsque la commande a été passée sans compte. Vous pouvez toujours afficher le PDF depuis le back-office et l’envoyer vous-même.

Je souhaite une autre apparence du PDF ou de l’e-mail. La carte reprend l’image du produit : changez donc l’image du produit. Les gabarits peuvent être surchargés depuis votre thème ; le fichier README.md du dossier du module en donne la liste.

Un texte est encore en anglais. Le module est traduit en anglais, en polonais et en français. Pour une autre langue, ouvrez International → Traductions → Traductions des modules installés et traduisez les textes du module, traduisez son e-mail dans les traductions d’e-mails de la même page, et saisissez le texte sur l’utilisation de la carte sur la page de configuration. Tant que l’e-mail n’est pas traduit, les commandes passées dans cette langue reçoivent l’e-mail anglais.

8. Mises à jour et assistance

Les mises à jour sont gratuites à vie : téléchargez les nouvelles versions depuis Mon compte → Historique des commandes sur addonspresta.com et installez-les comme un nouveau module. Vos réglages, vos produits cartes cadeaux et les cartes émises sont conservés.

L’assistance est incluse pendant 12 mois à compter de votre commande : écrivez à mail@addonspresta.com ou utilisez le formulaire de contact sur addonspresta.com (du lundi au vendredi, 10 h – 16 h CET ; nous répondons en général sous 2 jours ouvrés). Indiquez votre version de PrestaShop, la version du module et les étapes qui mènent au problème.

Retour : Manuels des modules