Billetterie & Événements — Guide complet
Installer, configurer et exploiter la billetterie : événements à placement libre ou à places numérotées, tarifs et jauge sans survente, plan de salle, noms des participants, billets PDF à QR code signé envoyés après paiement, page « Mes billets », contrôle d'entrée sur téléphone et rapports.
Présentation
DataFirefly Billetterie & Événements vend des billets d’événements dans PrestaShop : concerts, spectacles, ateliers, conférences, festivals. Vous créez un événement (date, lieu, capacité, tarifs), le module crée le produit, réserve les places dans les paniers pour ne jamais vendre plus que la jauge, envoie des billets PDF à QR code signé dès que la commande est payée, et votre équipe contrôle les entrées avec la caméra d’un téléphone.
Nouveau en 2.0.0 : réservations de places sans survente possible, billets à QR code signé, e-mail des billets après paiement, noms des participants, page « Mes billets », contrôle d’entrée sur téléphone, tableau de bord et rapports, compatibilité PrestaShop 1.7.8 à 9 et 8 langues.

Installation et mise à jour
- Dans le back-office, ouvrez Modules > Gestionnaire de modules, cliquez sur Téléverser un module et déposez
dfeventtickets-2.0.0.zip. - Le module crée ses tables et le menu Vendre > Billetterie (tableau de bord, événements, participants, contrôle d’entrée, réglages).
- À la première visite, le tableau de bord vous guide en quatre étapes : créer un événement, ajouter les tarifs, vendre un premier billet, contrôler les billets à l’entrée.
Mise à jour depuis la 1.0.0 : téléversez simplement le nouveau ZIP. Les événements, plans de salle et billets existants sont conservés ; les anciens QR codes restent acceptés au contrôle d’entrée. Les billets de commandes jamais payées passent « en attente de paiement » et deviennent valides dès le paiement.
Compatible PrestaShop 1.7.8, 8 et 9, thèmes Classic et Hummingbird (testé sous PHP 7.4, 8.1 et 8.5). Aucune dépendance externe, aucun service tiers.
Créer un événement
Ouvrez Billetterie > Événements puis Nouvel événement. Le formulaire est découpé en quatre parties :
- L’événement : titre, lieu, adresse, description et informations pratiques (imprimées sur chaque billet), dans chaque langue grâce au sélecteur de langue.
- Date et heure : début, fin et fuseau horaire du lieu. Les ventes se ferment automatiquement au début de l’événement.
- Billetterie : placement libre ou plan de salle, capacité, maximum de billets par commande, durée de réservation dans le panier, noms des participants (non demandés, facultatifs ou obligatoires), ouverture et fermeture des ventes.
- Tarifs : plein tarif, tarif réduit, VIP… chacun avec son prix TTC (le prix HT est calculé selon la TVA choisie), un quota facultatif et une couleur.
Le module crée pour vous un produit virtuel (pas de livraison) avec une déclinaison par tarif et l’image de l’événement. Vous pouvez aussi lier un produit existant. Les règles de prix catalogue et les bons de réduction s’appliquent normalement.
Vérifiez le taux de TVA applicable à vos billets dans votre pays (taux réduit pour certains spectacles). Gardez le produit virtuel et ne supprimez pas ses déclinaisons : elles portent les prix des tarifs.

Suivre les ventes en direct
La liste des événements affiche pour chaque date le statut des ventes (en vente, complet, ventes pas encore ouvertes, terminé), une jauge des places vendues et en attente de paiement (les places en cours dans des paniers sont hachurées), le chiffre d’affaires et le nombre d’entrées. Le menu d’actions permet d’ouvrir le rapport, le plan de salle, les participants, le contrôle d’entrée, de voir l’événement en boutique ou de le dupliquer pour une nouvelle date.

Dessiner le plan de salle
Pour un événement à places numérotées, chaque tarif est aussi une zone du plan. Ouvrez Plan de salle depuis l’événement :
- Ajouter un bloc : zone, nombre de rangées, sièges par rangée, première rangée, premier numéro, allée centrale et numérotation de droite à gauche ;
- Déplacer : glissez un siège, ou sélectionnez-en plusieurs avec un rectangle (touche Maj) et déplacez-les ensemble (flèches du clavier pour un ajustement fin) ;
- Changer de zone, Bloquer / débloquer une place (place technique, visibilité réduite) ou Supprimer.
Un siège déjà vendu n’est jamais supprimé ni changé de zone. Le plan fonctionne à la souris, au stylet et au doigt.

Côté boutique : choisir ses billets
Sur la page de l’événement, le module remplace le bloc d’achat par un bloc billetterie (thèmes Classic et Hummingbird) : date et heure, lieu avec lien vers la carte, statut (en vente, « plus que X places », complet, ouverture des ventes le…), tarifs avec quantités et places restantes, noms des participants, total, et ajout au calendrier (Apple, Outlook, Google Agenda).

Pour un événement à places numérotées, le client clique sur les sièges du plan : zones colorées avec leur prix, lettres de rangée, zoom et plein écran. Chaque place cliquée est ajoutée au panier et réservée, avec un minuteur.

Panier et réservation des places
Chaque billet dans un panier réserve une place pendant la durée choisie (15 minutes par défaut), prolongée tant que le client est dans le panier ou le tunnel de commande. Le panier affiche les billets, le temps restant et les noms des participants, modifiables à tout moment.
Si le client augmente une quantité alors que l’événement est presque complet, le panier est ajusté automatiquement et un message explique pourquoi. Aucune survente n’est possible, même quand plusieurs clients achètent les dernières places au même instant.

Paiement, billets et e-mail
À la commande, les billets sont « en attente de paiement ». Ils deviennent valides dès que la commande passe à un statut payé (paiement accepté, paiement à distance accepté, expédié, livré…) et le client reçoit un e-mail avec ses billets en PDF et un lien pour les afficher sur son téléphone. Un virement ou un chèque ne donne donc jamais de billet utilisable avant encaissement.

Le billet PDF (un par page) reprend l’événement, la date, l’heure, le lieu, le tarif, la place, le nom du participant, la commande, le prix payé et un QR code signé avec un code de secours à saisir à la main.

Commande annulée, remboursée ou en erreur de paiement : les billets sont annulés et les places remises en vente. Un avoir partiel annule le nombre de billets remboursés.
Espace client « Mes billets »
Le compte client comprend une page Mes billets : événements à venir et passés, QR code de chaque billet à présenter à l’entrée, téléchargement du PDF, ajout au calendrier, et noms des participants modifiables jusqu’au début de l’événement. Les clients sans compte (commande invité) accèdent à leurs billets par le lien sécurisé de l’e-mail.

Contrôle d’entrée
Le jour J, ouvrez Billetterie > Contrôle d’entrée sur un téléphone, une tablette ou un ordinateur. Choisissez l’événement contrôlé, puis :
- Caméra : démarrez la caméra et présentez le QR code du billet (papier ou téléphone) ;
- Code ou douchette : saisissez le code du billet, ou gardez le curseur dans le champ avec une douchette USB/Bluetooth.
Le résultat s’affiche en grand avec le nom du participant, le tarif et la place : vert pour une entrée valide, orange pour un billet déjà utilisé (avec l’heure et l’agent du premier passage), rouge pour un billet annulé, non payé, d’un autre événement ou invalide. Un compteur affiche les entrées sur le nombre de billets attendus.

Même avec plusieurs agents à plusieurs portes, un billet ne peut entrer qu’une seule fois. Une entrée enregistrée par erreur peut être annulée.

Participants et export
Billetterie > Participants liste tous les billets : nom du participant, acheteur, événement, tarif, place, code, commande et statut. Filtrez par événement ou statut, cherchez un nom, un e-mail, une commande ou un code. Pour chaque billet : PDF, entrée manuelle ou annulation d’entrée, renvoi de l’e-mail, modification du participant, annulation du billet. L’export CSV est compatible avec les tableurs et protégé contre l’injection de formules.

Rapport de l’événement
Le rapport d’un événement affiche les billets vendus et la jauge, le chiffre d’affaires et le billet moyen, les billets en attente de paiement, les places en cours dans des paniers, le taux d’entrée, les ventes par tarif, les ventes des 30 derniers jours, les arrivées par quart d’heure et les derniers scans.

Réglages
- durée de réservation des places dans le panier et maximum de billets par commande (par défaut) ;
- noms des participants par défaut et possibilité pour le client de les modifier ;
- seuil d’affichage « plus que X places » ;
- envoi de l’e-mail des billets et pièce jointe PDF ;
- couleur d’accent (billet, e-mail, boutique) ;
- RGPD : anonymisation des noms de participants N mois après l’événement ;
- suppression des données à la désinstallation (désactivée par défaut : les billets vendus sont conservés).
Sécurité
- QR code signé (HMAC) : un billet ne peut pas être fabriqué ; un QR modifié est refusé.
- Une seule entrée par billet, même avec plusieurs scanners simultanés.
- Liens de téléchargement signés : un client ne peut jamais télécharger les billets d’un autre.
- Plafond de places réservées par commande et par connexion pour empêcher un robot de bloquer une salle.
- Aucun service externe : le décodeur QR de l’écran de contrôle est embarqué.
RGPD et multiboutique
Le module s’intègre au module officiel RGPD de PrestaShop (export et effacement des données d’un client). Les noms de participants peuvent être anonymisés automatiquement après l’événement. En multiboutique, chaque événement appartient à une boutique.
Dépannage
La caméra ne démarre pas
Le navigateur exige une connexion sécurisée (HTTPS) et l’autorisation d’utiliser la caméra. À défaut, saisissez le code du billet ou utilisez une douchette.
Le client n’a pas reçu ses billets
Vérifiez que la commande est à un statut payé. Depuis la page commande ou la liste des participants, utilisez Renvoyer les billets.
Une livraison est demandée au paiement
Le produit de l’événement doit rester virtuel. Un message vous prévient dans le formulaire de l’événement s’il ne l’est pas.
Un billet est marqué « à vérifier »
Le client a payé après l’expiration de sa réservation alors que la place a été reprise entre-temps. Contactez-le pour proposer une autre place ou un remboursement, puis marquez le billet comme vérifié.