DataFirefly Marketplace — Complete guide
Install, configure and run your multi-vendor marketplace on PrestaShop 8 and 9.
Overview
DataFirefly Marketplace turns your PrestaShop store into a multi-vendor marketplace. Third-party sellers register, publish their products and manage their orders, while you orchestrate commissions, payments and compliance from the back office.
The module covers the full cycle: seller registration and approval, a complete seller area, real order splitting into sub-orders, a commission engine, regulated split payments (Mangopay and Stripe Connect), per-seller shipping, EU compliance (DSA, P2B, VAT), reviews, messaging, plans, disputes and analytics — all in five languages (FR, EN, ES, DE, IT).
Compatibility and requirements
- PrestaShop 8.0, 8.1, 8.2 and 9.x
- PHP 8.1 or higher
- Multistore and multilingual
- For split payments: a Mangopay and/or Stripe Connect account (sandbox keys for testing, production keys for live use)
Installation
- In the back office, go to Modules > Module Manager, click Upload a module and select the
dfmarketplace.ziparchive. - Installation creates the required tables, registers the hooks and adds the Marketplace menu to the back office, along with a demo dataset (plans and commission rules).
- Open Marketplace > Configuration to set up the module.
On uninstall, the data tables are kept on purpose so you do not lose the history of sellers, orders and commissions.
Initial configuration
In Marketplace > Configuration, set the main parameters:
- Default commission: rate applied when no more specific rule exists (15% by default).
- Default payment provider: Mangopay or Stripe Connect, then the matching keys.
- Hybrid mode: lets the operator sell their own products alongside third-party sellers.
- Invoice child orders: generates a dedicated invoice for each seller sub-order.
- Escrow release state: order state that triggers the release of funds to seller wallets (for example “Shipped” or “Delivered”).
- Show seller identity (DSA): enables the professional seller identity block on the storefront.
- Commission invoice prefix and P2B notice (days).
- Automatic product approval: when enabled, seller products are published without moderation.
Seller management
Registration
A logged-in customer can become a seller via the module’s registration page (linked from their account). They enter the shop name, legal form and legal details. An acknowledgement email is sent.
Approval and KYC
From Marketplace > Sellers, the operator can approve, suspend or reject a seller. On approval, PSP onboarding is triggered and an approval email is sent. The seller can upload their KYC documents (registration extract, ID, bank details) from their dashboard.
In line with the P2B regulation, any suspension is accompanied by an email informing the seller, with a statement of reasons provided separately.
Seller area
Each seller has a partitioned dashboard: they only access their own data.
- Dashboard: wallet balance, amount to be paid out, number of products, status, orders, ledger.
- My profile: logo, banner, presentation, return and shipping policies, public contact details and DSA fields.
- My products: create and edit complete sheets (photos, reference/SKU, EAN, condition, price and VAT, quantity, category, weight and dimensions, descriptions).
- Shipping: select offered carriers and fee rules (by price or weight, by zone, with free-shipping threshold).
Order splitting
When an order contains products from several sellers, the module splits it into genuine child orders (one per seller). Each sub-order has its own shipping fees, frozen commission, invoice and wallet credit. The logical detail is kept for traceability, and partitioning between sellers is strict.
The parent order invoice follows the native PrestaShop flow. On your version, check that the payment module does not freeze a parent invoice for the full amount before the split.
Commissions
The engine applies a cascade of rules, from most specific to most general: product › seller › category › global, falling back to the default commission. Rules can be percentage, fixed amount or hybrid, on a tax-inclusive or tax-exclusive base.
Monthly turnover tiers are supported: for example, 15% up to 5,000 € of monthly turnover, then 12% above. The commission is frozen at order time and never recalculated.
Split payment, wallet and escrow
The Mangopay and Stripe Connect adapters collect funds in a split fashion and hold them in escrow. When the configured order state is reached, the funds are released to seller wallets.
Payouts
The seller requests a payout from their dashboard. The operator runs payouts from Marketplace > Commissions & payments in one click (SEPA transfer via the PSP). Every movement is tracked in the wallet ledger.
Webhooks
Configure the module’s webhook URL on the PSP side (controller webhook) to synchronise payment statuses. The signature is verified on every call.
Per-seller shipping
Each seller defines their carriers and fee rules. When shipping, they enter the carrier and tracking number from their dashboard: an email is sent to the buyer, and once all sub-orders of an order are shipped, the parent order automatically moves to the “Shipped” status.
EU compliance
- DSA: the professional seller identity (company, registration number, VAT, point of contact) is shown on their storefront.
- Commission invoices: generated automatically per monthly period, numbered and archived. The operator can run bulk generation from Marketplace > Commission invoices.
- P2B: a page publishes the seller terms, ranking parameters and the notice period for changes.
- VAT “platform deemed supplier”: a per-seller indicator is displayed and carried over to the commission invoice.
The module exposes and displays the VAT indicator but does not embed an OSS allocation engine. Fine-grained VAT allocation remains driven by your store tax configuration.
Reviews, messaging, plans, disputes and analytics
- Reviews: buyers who ordered from a seller can leave a review, moderated from Marketplace > Reviews. The average rating is recalculated automatically.
- Messaging: threads between buyer, seller and operator; seller-side inbox.
- Seller plans: Free, Pro and Premium by default, with product quotas, commission rate and analytics access. Managed from Marketplace > Seller plans.
- Disputes and returns: opened per sub-order, resolved from Marketplace > Disputes & returns, with any refund carried over to the seller wallet.
- Analytics: operator view (GMV, take rate, top sellers) in Marketplace > Analytics, and per-seller statistics (gated by plan) in their dashboard.
Back-office tabs
The Marketplace menu groups: Sellers, Seller orders, Commissions & payments, Commission invoices, Reviews, Disputes & returns, Seller plans, Analytics and Configuration.
FAQ and troubleshooting
Funds are not released to sellers
Check that the “Escrow release state” is set in the configuration and that the sellers concerned have completed PSP onboarding (wallet created).
A seller product does not appear in the shop
A product stays hidden until it is approved. Check its validation status in the seller’s product list, or enable automatic approval.
After an update, an admin screen errors out
Clear the PrestaShop cache (the var/cache folder) after installation or update, then reload the back office.