DataFirefly Marketplace — Guide complet

Présentation

DataFirefly Marketplace transforme votre boutique PrestaShop en place de marché multi-vendeurs. Des vendeurs tiers s’inscrivent, publient leurs produits et gèrent leurs commandes, pendant que vous orchestrez les commissions, les paiements et la conformité depuis le back-office.

Le module couvre l’ensemble du cycle : inscription et validation des vendeurs, espace vendeur complet, découpage réel des commandes en sous-commandes, moteur de commissions, paiement éclaté régulé (Mangopay et Stripe Connect), livraison par vendeur, conformité européenne (DSA, P2B, TVA), avis, messagerie, plans, litiges et analytics — le tout en cinq langues (FR, EN, ES, DE, IT).

Compatibilité et prérequis

• PrestaShop 8.0, 8.1, 8.2 et 9.x
• PHP 8.1 ou supérieur
• Multiboutique et multilingue
• Pour le paiement éclaté : un compte Mangopay et/ou Stripe Connect (clés sandbox pour les tests, clés de production pour l’exploitation)

Installation

1. Dans le back-office, allez dans Modules > Module Manager, cliquez sur Téléverser un module et sélectionnez l’archive dfmarketplace.zip.
2. L’installation crée les tables nécessaires, enregistre les hooks et ajoute le menu Marketplace dans le back-office, ainsi qu’un jeu de données de démonstration (plans et règles de commission).
3. Ouvrez Marketplace > Configuration pour paramétrer le module.

Configuration initiale

Dans Marketplace > Configuration, renseignez les paramètres principaux :

• Commission par défaut : taux appliqué quand aucune règle plus spécifique n’existe (15 % par défaut).
• Prestataire de paiement par défaut : Mangopay ou Stripe Connect, puis les clés correspondantes.
• Mode hybride : autorise l’opérateur à vendre ses propres produits aux côtés des vendeurs tiers.
• Facturer les commandes filles : génère une facture dédiée pour chaque sous-commande vendeur.
• État libérant l’escrow : état de commande qui déclenche la libération des fonds vers les portefeuilles vendeurs (par exemple « Expédié » ou « Livré »).
• Afficher l’identité vendeur (DSA) : active le bloc d’identité du vendeur professionnel sur la vitrine.
• Préfixe de facture de commission et préavis P2B (jours).
• Validation automatique des produits : si activée, les produits vendeurs sont publiés sans modération.

Gestion des vendeurs

Inscription

Un client connecté peut devenir vendeur via la page d’inscription du module (lien depuis son compte). Il renseigne le nom de la boutique, sa forme juridique et ses informations légales. Un e-mail d’accusé de réception lui est envoyé.

Validation et KYC

Depuis Marketplace > Vendeurs, l’opérateur peut approuver, suspendre ou rejeter un vendeur. À l’approbation, l’onboarding PSP est déclenché et un e-mail de validation est envoyé. Le vendeur peut téléverser ses pièces KYC (Kbis, pièce d’identité, RIB) depuis son tableau de bord.

Espace vendeur

Le vendeur dispose d’un tableau de bord cloisonné : il n’accède qu’à ses propres données.

• Tableau de bord : solde du portefeuille, montant à reverser, nombre de produits, statut, commandes, grand-livre.
• Mon profil : logo, bannière, présentation, politiques de retour et de livraison, coordonnées publiques et champs DSA.
• Mes produits : création et édition de fiches complètes (photos, référence/SKU, EAN, état, prix et TVA, quantité, catégorie, poids et dimensions, descriptions).
• Livraison : sélection des transporteurs proposés et règles de frais (par prix ou poids, par zone, avec seuil de gratuité).

Découpage des commandes

Lorsqu’une commande contient des produits de plusieurs vendeurs, le module la découpe en véritables commandes filles (une par vendeur). Chaque sous-commande possède ses propres frais de port, sa commission figée, sa facture et son crédit de portefeuille. Le détail logique est conservé pour la traçabilité, et le cloisonnement entre vendeurs est strict.

Commissions

Le moteur applique une cascade de règles, de la plus spécifique à la plus générale : produit › vendeur › catégorie › global, avec repli sur la commission par défaut. Les règles peuvent être en pourcentage, en montant fixe ou hybride, sur une base TTC ou HT.

Des paliers de chiffre d’affaires mensuel sont pris en charge : par exemple, 15 % jusqu’à 5 000 € de CA mensuel, puis 12 % au-delà. La commission est figée au moment de la commande et n’est jamais recalculée.

Paiement éclaté, portefeuille et escrow

Les adaptateurs Mangopay et Stripe Connect encaissent les fonds de façon éclatée et les conservent en escrow. À l’atteinte de l’état de commande configuré, les fonds sont libérés vers les portefeuilles vendeurs.

Reversements

Le vendeur demande un retrait depuis son tableau de bord. L’opérateur exécute les reversements depuis Marketplace > Commissions & paiements en un clic (virement SEPA via le PSP). Chaque mouvement est tracé dans le grand-livre du portefeuille.

Webhooks

Configurez l’URL de webhook du module côté PSP (contrôleur webhook) afin de synchroniser les statuts de paiement. La signature est vérifiée à chaque appel.

Livraison par vendeur

Chaque vendeur définit ses transporteurs et ses règles de frais. Lors de l’expédition, il saisit le transporteur et le numéro de suivi depuis son tableau de bord : un e-mail est envoyé à l’acheteur, et lorsque toutes les sous-commandes d’une commande sont expédiées, la commande parente passe automatiquement au statut « Expédié ».

Conformité européenne

• DSA : l’identité du vendeur professionnel (raison sociale, numéro d’enregistrement, TVA, point de contact) est affichée sur sa vitrine.
• Factures de commission : générées automatiquement par période mensuelle, numérotées et archivées. L’opérateur peut lancer la génération en masse depuis Marketplace > Factures de commission.
• P2B : une page publie les conditions applicables aux vendeurs, les paramètres de classement et le préavis en cas de modification.
• TVA « plateforme réputée fournisseur » : un indicateur par vendeur est affiché et reporté sur la facture de commission.

Avis, messagerie, plans, litiges et analytics

• Avis : les acheteurs ayant commandé chez un vendeur peuvent laisser un avis, modéré depuis Marketplace > Avis. La note moyenne est recalculée automatiquement.
• Messagerie : fils de discussion entre acheteur, vendeur et opérateur ; boîte de réception côté vendeur.
• Plans vendeur : Free, Pro et Premium par défaut, avec quotas de produits, taux de commission et accès analytics. Gérés depuis Marketplace > Plans vendeur.
• Litiges et retours : ouverts par sous-commande, résolus depuis Marketplace > Litiges & retours, avec remboursement éventuel répercuté sur le portefeuille du vendeur.
• Analytics : vue opérateur (GMV, taux de commission, meilleurs vendeurs) dans Marketplace > Analytics, et statistiques par vendeur (gated par le plan) dans son tableau de bord.

Onglets du back-office

Le menu Marketplace regroupe : Vendeurs, Commandes vendeurs, Commissions & paiements, Factures de commission, Avis, Litiges & retours, Plans vendeur, Analytics et Configuration.

FAQ et dépannage

Les fonds ne sont pas libérés vers les vendeurs

Vérifiez que l’« État libérant l’escrow » est bien défini dans la configuration et que les vendeurs concernés ont terminé leur onboarding PSP (portefeuille créé).

Un produit vendeur n’apparaît pas en boutique

Un produit reste masqué tant qu’il n’est pas approuvé. Vérifiez son statut de validation dans la liste des produits du vendeur, ou activez la validation automatique.

Après mise à jour, un écran d’administration est en erreur

Videz le cache PrestaShop (dossier var/cache) après l’installation ou la mise à jour, puis rechargez le back-office.