Skip to main content
The Magento 2 connector turns a store you already run into a marketplace. Shoppers keep using your Magento storefront, cart and checkout. Sellers list offers in Mercur, and those offers appear on your product pages next to your own stock. One checkout can mix your products and products from several sellers, and the shopper pays once. After checkout, Magento keeps the order and the payment. Mercur splits the seller lines into one order per seller, computes commission and tracks what each seller owes and is owed.

​
Who owns what

Magento never sees a seller’s stock levels as its own, and Mercur never charges the shopper. Each side reads what it needs from the other through the API and webhooks.

​
What you get

  • A buy box on every product page: your own stock and every active seller offer, with per-website prices, price list strike-through, quantity tiers and an estimated delivery date
  • Seller-only products: published seller products are imported as simple or configurable products, with images, and stay buyable while any offer is in stock
  • Your catalog in Mercur: your own products can be pushed to Mercur so sellers can list offers against them, matched by SKU or by EAN, UPC or GTIN
  • One checkout: lines grouped by seller, a shipping choice per seller and “Sold by” on every line, and a “Seller shipping” total on the cart, order, invoice and emails
  • One payment, split after capture: the order is created in Mercur with the payment authorized, and the capture is confirmed when Magento invoices
  • Seller fulfillment: every shipment a seller creates becomes a Magento shipment with tracking, including partial and multi-parcel deliveries
  • Refunds in both directions: a Magento credit memo is reported to Mercur, and a refund started in Mercur becomes a Magento credit memo
  • Seller pages at /seller/{handle}, and GraphQL and REST support for headless storefronts

​
Two packages

The integration ships as two packages, one on each side:

​
Compatibility

Stores running Multi-Source Inventory enable one extra module, Mercur_Inventory.

​
Not supported yet

  • Buyer and seller messaging, order incidents and seller ratings
  • Documents sellers attach to orders
  • A third-party tax engine for seller lines. Magento taxes them with the product’s tax class
  • Mercur promotions. Magento cart price rules never apply to seller lines
  • Shipping one order to several addresses

​
Get started

Quickstart

Connect a Magento store to Mercur and place a first mixed order.

Architecture

What runs on each side, how they sync and how an order travels.

Configuration

Every setting on both sides, its scope and its default.

Reference

Scheduled jobs, CLI, webhook events, routes and the GraphQL schema.

​
Guides

Catalog and offers

Sellers, offers, the buy box, product import and push.

Storefront

Product page, cart, checkout, seller pages and GraphQL.

Orders and payments

Placement, capture, shipments, returns and refunds.