PS PrestaShop Intermédiaire

DataFirefly Marketplace : guide complet

Installer, configurer et exploiter votre place de marché multi-vendeurs sur PrestaShop 8 et 9.

Mis à jour Version du module 2.0.0

Présentation

DataFirefly Marketplace transforme votre boutique PrestaShop en place de marché multi-vendeurs. Des vendeurs indépendants s’inscrivent, publient leurs produits, préparent et expédient leurs commandes et répondent à leurs clients depuis un espace dédié sur la boutique. Vous validez les vendeurs et leurs produits, fixez les commissions, versez les fonds et suivez l’activité depuis le back-office.

Chaque commande passée chez plusieurs vendeurs est découpée en vraies commandes PrestaShop, une par vendeur, avec des totaux exacts et un seul paiement. Le solde de chaque vendeur est crédité au paiement, devient retirable après une période de sécurité, puis lui est versé par virement (ou via Mangopay ou Stripe Connect si vous les utilisez). Aucune tâche planifiée n’est nécessaire.

L’interface, le back-office et les 16 e-mails sont traduits en français, anglais, espagnol, allemand, italien, néerlandais, polonais et portugais.

Nouveautés de la version 2.0

  • Montants toujours exacts : la somme des commandes vendeurs est égale à ce que le client a payé (frais de port et remises compris), avec un seul paiement pour toute la commande.
  • Solde crédité au paiement, période de sécurité, contre-passation automatique des annulations, remboursements et avoirs.
  • Retraits complets : demande avec montant, réservation immédiate, virement avec référence ou refus motivé, export CSV.
  • Frais de port fixés par chaque vendeur grâce au transporteur « Marketplace », affichés vendeur par vendeur dans le panier.
  • Nouveau back-office : tableau de bord avec tendances et file « À traiter », fiche vendeur complète, file de modération des produits, règles de commission avec simulateur.
  • Nouvel espace vendeur : navigation commune, ventes et net sur 12 mois, finances détaillées, réponses aux avis, mode vacances.
  • Sécurité renforcée : jetons anti-CSRF, contenus des vendeurs filtrés, données client limitées au strict nécessaire, vérification de l’IBAN.

Compatibilité et prérequis

  • PrestaShop 8.0, 8.1, 8.2 et 9.x (testé sur 8.2.1 avec le thème Classic et sur 9.1.5 avec Hummingbird)
  • PHP 8.1 ou supérieur
  • Multilingue ; aucune tâche planifiée (cron) nécessaire
  • Optionnel : un compte Mangopay ou Stripe Connect pour verser les vendeurs automatiquement. Sans compte, les vendeurs sont payés par virement manuel.

Installation

  1. Dans le back-office, ouvrez Modules > Gestionnaire de modules, cliquez sur Téléverser un module et sélectionnez dfmarketplace-2.0.0.zip.
  2. L’installation crée les tables, ajoute le menu Marketplace sous Vendre (libellés dans la langue de chaque employé), le transporteur « Marketplace » (désactivé tant que vous n’utilisez pas les frais par vendeur) et trois plans vendeur : Free, Pro et Premium.
  3. Ouvrez Marketplace > Configuration. Le lien d’inscription des vendeurs est affiché en haut de la page : partagez-le ou ajoutez-le à votre menu.

Mise à jour depuis la version 1.x

Téléversez dfmarketplace-2.0.0.zip dans le gestionnaire de modules, sans désinstaller. PrestaShop lance la mise à jour automatiquement :

  • les vendeurs, produits, commandes, messages, avis et historiques sont conservés ;
  • les soldes des vendeurs sont repris au centime et les demandes de retrait en cours restent à traiter ;
  • les anciens menus sont remplacés par les nouveaux, sans toucher aux menus des autres modules ;
  • si aucune clé Mangopay ou Stripe n’est enregistrée, le mode de paiement des vendeurs passe en virements manuels.

Après la mise à jour, videz le cache depuis Paramètres avancés > Performances, puis vérifiez la configuration : délai de sécurité, retrait minimum et mode de livraison sont de nouveaux réglages.

Configuration

La page Marketplace > Configuration est organisée en sections.

Vendeurs et produits

  • Valider automatiquement les vendeurs et Publier les produits sans modération : désactivés par défaut, chaque demande attend votre validation.
  • Re-modérer un produit modifié : un produit publié repasse en validation après chaque modification par le vendeur.
  • Catégories proposées aux vendeurs : les vendeurs choisissent parmi cette catégorie et ses sous-catégories.
  • Publier les avis sans modération et Afficher « Du même vendeur » sur la fiche produit.

Commissions et facturation

  • Commission par défaut : appliquée quand aucune règle ne correspond.
  • Remises (bons de réduction) : à la charge de la plateforme, ou déduites du net du vendeur au prorata.
  • Préfixe des factures de commission et TVA sur la commission.
  • Facture PrestaShop pour chaque commande vendeur.

Soldes et retraits des vendeurs

  • Mode de paiement des vendeurs : virements manuels (par défaut), Mangopay ou Stripe Connect.
  • Délai de sécurité (14 jours par défaut) : une vente devient retirable après ce délai suivant le paiement, ou dès sa livraison.
  • Retrait minimum et, en option, Libérer aussi les fonds à l’état choisi.
  • Le vendeur peut marquer une commande « livrée ».

Livraison

  • Frais de port : transporteurs de la boutique (frais encaissés par la plateforme) ou frais fixés par chaque vendeur (transporteur « Marketplace »).
  • Frais d’un vendeur sans règle, Frais pour vos propres produits et Proposer uniquement « Marketplace » pour les paniers vendeurs.

Notifications et conformité

  • M’alerter par e-mail : nouveau vendeur, produit à valider, demande de retrait, litige. Adresse des alertes au choix.
  • Afficher l’identité des vendeurs professionnels (DSA).
  • Préavis de modification des conditions (15 jours minimum) et Conditions applicables aux vendeurs (P2B), éditables dans chaque langue.

Prestataire de paiement (optionnel)

Clés Mangopay ou Stripe Connect, uniquement si vous les utilisez. Les clés enregistrées ne sont jamais réaffichées : laissez un champ vide pour conserver la clé actuelle.

Désinstallation

Supprimer toutes les données à la désinstallation : désactivé par défaut, pour ne jamais perdre les soldes et l’historique des vendeurs.

Configuration de la marketplace en sections
Configuration

Tableau de bord

Marketplace > Tableau de bord réunit l’essentiel : ventes payées, commissions, taux moyen, nombre de commandes et panier moyen avec leur tendance, fonds dus aux vendeurs, graphique sur 12 mois, meilleurs vendeurs et dernières commandes.

La file À traiter compte les vendeurs à valider, les produits et les avis à modérer, les retraits à payer, les justificatifs et IBAN à vérifier et les litiges ouverts, avec un lien direct vers chaque écran.

Tableau de bord de la marketplace : ventes, commissions et tâches à traiter
Tableau de bord

Vendeurs

Inscription

Un client connecté devient vendeur depuis la page d’inscription. Il renseigne le nom de sa boutique, son statut (particulier ou professionnel), ses informations légales, son IBAN et son BIC, puis accepte les conditions vendeurs. L’IBAN est contrôlé (clé de contrôle) et les valeurs saisies sont conservées en cas d’erreur.

Validation, suspension et refus

La liste Marketplace > Vendeurs affiche le statut, le KYC, l’IBAN, les ventes et le solde de chaque vendeur. La fiche vendeur permet de valider, suspendre ou refuser avec un motif, envoyé au vendeur par e-mail comme l’exige le règlement P2B.

Quand un vendeur est suspendu ou refusé, ses produits sont retirés de la vente et il ne peut plus en ajouter ni en modifier. Ils sont remis en ligne s’il est réactivé.

Justificatifs, IBAN et portefeuille

La fiche vendeur regroupe aussi :

  • les justificatifs KYC, ouverts depuis le back-office, avec validation ou refus du KYC ;
  • la vérification de l’IBAN : un IBAN modifié par le vendeur bloque ses retraits jusqu’à votre vérification ;
  • le portefeuille, avec les mouvements et un ajustement manuel tracé (geste commercial, régularisation) ;
  • les dernières commandes et une note interne visible uniquement par l’équipe.

Les justificatifs KYC et les factures de commission sont stockés dans des dossiers protégés, sous des noms de fichiers non devinables. Sur Nginx, interdisez l’accès à /modules/dfmarketplace/docs/kyc/ et /modules/dfmarketplace/docs/commission/.

Liste des vendeurs avec statut, KYC, IBAN, ventes et solde
Liste des vendeurs
Fiche vendeur : décision motivée, justificatifs, IBAN et portefeuille
Fiche vendeur

Produits et modération

Le vendeur crée ses produits depuis son espace : photos, prix saisi TTC (le prix HT est affiché), TVA, stock, catégories autorisées, poids et dimensions, descriptions.

Marketplace > Produits vendeurs présente la file de modération avec des filtres par statut et par vendeur. La page d’examen montre les photos, le prix et la description. Vous publiez le produit, ou vous le renvoyez au vendeur avec un motif qu’il voit dans son espace et reçoit par e-mail. La publication groupée est possible.

File de modération des produits proposés par les vendeurs
Modération des produits

Espace vendeur

Le vendeur gère son activité depuis la boutique, sans accès au back-office, et ne voit que ses propres données. Toutes les pages partagent la même navigation, avec le nombre d’éléments à traiter.

Tableau de bord

Commandes à préparer, ventes sur 30 jours avec tendance, montant disponible au retrait, commissions et note moyenne, ventes et net sur 12 mois, meilleures ventes. Une liste « Bien démarrer » le guide jusqu’à sa première vente.

Espace vendeur : commandes à préparer, ventes, solde et graphique
Espace vendeur

Produits

Liste avec filtres par statut, recherche et stock modifiable directement. Un produit refusé affiche le motif du refus.

Catalogue du vendeur avec statut de modération et stock modifiable
Produits du vendeur

Commandes

Filtres, recherche et pagination. La page de chaque commande présente les articles, le net du vendeur après commission, le transporteur choisi par le client, son message et la conversation. Le vendeur prend en charge la commande, imprime le bon de préparation, déclare un ou plusieurs colis avec le numéro et le lien de suivi, puis marque la commande comme livrée (si vous l’autorisez).

L’adresse et le téléphone du client ne sont visibles qu’une fois la commande payée ; son adresse e-mail n’est jamais communiquée au vendeur.

Commande côté vendeur : articles, net, expédition avec suivi et messages
Commande vendeur

Finances

Le vendeur voit son solde réparti en disponible, en période de sécurité et retraits en cours. Il demande un retrait, peut l’annuler tant qu’il n’est pas payé, et retrouve l’historique, ses factures de commission et le relevé de tous les mouvements.

Finances du vendeur : disponible, période de sécurité, retraits et factures
Finances du vendeur

Avis, profil et vacances

  • Avis : répartition des notes et réponse publique à chaque avis.
  • Profil : logo, bannière, présentation, politiques de livraison et de retour, coordonnées publiques, informations DSA, IBAN.
  • Mode vacances : un message s’affiche sur la boutique et les fiches produit du vendeur.
  • Livraison : règles de frais par montant ou par poids, par zone, avec livraison offerte à partir d’un montant.

L’espace vendeur s’adapte aux téléphones.

Espace vendeur sur mobile
Espace vendeur sur mobile

Découpage des commandes

Quand un panier contient des produits de plusieurs vendeurs, la commande est découpée en vraies commandes PrestaShop, une par vendeur, avec la même référence. Les frais de port et les remises sont répartis, si bien que la somme des commandes est égale au montant payé par le client. Un seul paiement couvre l’ensemble, y compris quand un virement ou un chèque est validé plus tard.

L’e-mail de confirmation de commande affiche le total complet et joint les factures de tous les vendeurs dans un seul PDF. Un panneau « Marketplace » sur la page commande du back-office montre la répartition par vendeur.

Découpage d'une commande par vendeur sur la page commande du back-office
Découpage de la commande

Commissions

Marketplace > Règles de commission permet de créer des règles par produit, par vendeur, par catégorie ou globales, en pourcentage ou en montant fixe, avec des paliers selon les ventes du mois. La règle la plus précise s’applique ; à défaut, le taux du plan du vendeur, puis la commission par défaut.

Le simulateur indique la commission et le net du vendeur pour un produit, un vendeur et un montant donnés. La commission est figée au moment de la commande.

Règles de commission par produit, vendeur, catégorie avec simulateur
Règles de commission

Soldes et retraits

Crédit et période de sécurité

Le net de chaque commande vendeur est crédité au paiement, jamais avant. Il reste en période de sécurité pendant le délai choisi, puis devient retirable ; il l’est dès la livraison si elle intervient avant. Un litige ouvert bloque la libération.

Annulation, remboursement total ou échec de paiement : le montant est retiré du solde du vendeur, qui est prévenu. Un avoir (remboursement partiel) débite la part du vendeur, une seule fois.

Demande et paiement des retraits

  1. Le vendeur demande un retrait depuis ses finances, dans la limite du disponible et au-dessus du minimum. Le montant est réservé aussitôt.
  2. Dans Marketplace > Retraits vendeurs, vous effectuez le virement puis cliquez sur Marquer comme payé en indiquant la référence. Vous pouvez aussi refuser avec un motif : le montant est rendu au vendeur.
  3. Le vendeur reçoit l’e-mail « virement effectué » ou « demande refusée ».

L’export CSV liste les virements à faire. Si Mangopay ou Stripe Connect est configuré, le versement peut être exécuté par le prestataire.

Traitement d'une demande de retrait : virement avec référence ou refus motivé
Demande de retrait
E-mail envoyé au vendeur quand son virement est effectué
E-mail de virement au vendeur

Livraison

Deux modes sont proposés :

  • Transporteurs de la boutique : vos transporteurs habituels, les frais sont encaissés par la plateforme.
  • Frais fixés par chaque vendeur : le transporteur « Marketplace » calcule les frais de chaque vendeur selon ses règles. Le panier affiche les vendeurs et leurs frais, et chaque vendeur reçoit ses frais avec sa commande.

Quand un vendeur confirme l’expédition, sa commande passe à l’état « Expédié ». Le client reçoit un e-mail par colis, avec le transporteur et le lien de suivi.

Panier multi-vendeurs avec frais de livraison de chaque vendeur
Panier multi-vendeurs

Pages publiques

  • Annuaire des vendeurs avec recherche, à l’adresse /marketplace.
  • Boutique de chaque vendeur à l’adresse /marketplace/nom-de-la-boutique : bannière, badges de confiance, produits avec tri et pagination, avis vérifiés avec réponse du vendeur, répartition des notes, politiques et informations légales DSA.
  • Fiche produit : bloc « Vendu et expédié par » avec la note du vendeur et un lien pour lui écrire, et bloc « Du même vendeur ».
  • Panier : « Vendu par » sur chaque ligne et récapitulatif des vendeurs.
Boutique publique d'un vendeur avec bannière, produits et avis vérifiés
Boutique du vendeur
Fiche produit avec le bloc « Vendu et expédié par »
Fiche produit « Vendu par »

Espace acheteur et messagerie

Dans Mon compte, l’acheteur retrouve ses commandes regroupées par vendeur, avec les étapes, les colis et leur lien de suivi. Il écrit au vendeur avant ou après l’achat, signale un problème ou demande un retour, puis laisse un avis.

Chaque nouveau message déclenche un e-mail au destinataire. Le vendeur ne peut écrire qu’à un client qui a commandé chez lui ou qui l’a contacté.

Avis, litiges et plans

  • Avis vérifiés : un avis par commande, possible seulement après l’expédition. Modération dans Marketplace > Avis vendeurs, réponse publique du vendeur.
  • Litiges et retours : conversation entre client et vendeur, clôture unique avec remboursement plafonné au montant de la commande vendeur, imputé à son solde, et e-mail aux deux parties.
  • Plans vendeur : quota de produits, taux de commission et accès aux statistiques, gérés dans Marketplace > Plans vendeur.

Conformité européenne

  • DSA : identité du vendeur professionnel affichée sur sa boutique.
  • P2B : conditions vendeurs publiées et acceptées à l’inscription, décisions motivées, avis de modification envoyé à tous les vendeurs avec le préavis choisi.
  • Factures de commission : générées par mois dans Marketplace > Factures de commission, avec ventilation HT, TVA et TTC, détail des commandes et numérotation continue, rédigées dans la langue du vendeur.
  • Données personnelles : le vendeur ne reçoit que les données nécessaires à la livraison, et seulement pour une commande payée.

E-mails

16 modèles HTML et texte : inscription reçue, vendeur validé, demande refusée, compte suspendu (avec motif), modification des conditions, nouvelle commande, commande expédiée, commande annulée, nouveau message, litige ouvert, litige clos, produit validé, produit refusé, virement effectué, retrait refusé et alerte de la plateforme. Chacun part dans la langue de son destinataire. Personnalisez-les dans International > Traductions > Traductions des e-mails.

Langues

Le module est traduit en français, anglais, espagnol, allemand, italien, néerlandais, polonais et portugais. Pour modifier un texte, ouvrez International > Traductions, choisissez Traductions des modules installés, puis DataFirefly Marketplace et la langue.

Désinstallation

Par défaut, la désinstallation retire les menus et les réglages mais conserve les vendeurs, les soldes et l’historique. Pour tout effacer, activez Supprimer toutes les données à la désinstallation dans la configuration avant de désinstaller.

FAQ et dépannage

Un vendeur ne peut pas demander de retrait

Vérifiez que son montant disponible dépasse le retrait minimum, que son IBAN a été vérifié et qu’aucun litige n’est ouvert sur ses ventes récentes.

Les ventes restent « en période de sécurité »

Elles deviennent retirables après le délai de sécurité ou dès la livraison. Réduisez le délai, ou choisissez un état dans « Libérer aussi les fonds à l’état ».

Un produit vendeur n’apparaît pas en boutique

Il attend probablement la modération, ou son vendeur est suspendu ou en attente de validation. Consultez Marketplace > Produits vendeurs.

Les frais de port des vendeurs ne s’affichent pas

Choisissez « Frais fixés par chaque vendeur » dans la section Livraison : le transporteur « Marketplace » est alors activé. Vérifiez qu’il est disponible pour la zone du client.

Après une mise à jour, une page n’a pas changé

Videz le cache depuis Paramètres avancés > Performances, puis rechargez la page.

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

Toujours bloqué ? Contactez le support