Skip to main content
In this document, you’ll learn how Mercur controls which stores are allowed to sell a shared master product.

Product seller

Since the catalog is shared, Mercur needs a way to say which stores may sell a given master product. That’s the product–seller allowlist: a many-to-many link between Medusa’s Product and Mercur’s Seller, stored in the product_seller table.
A store appears in a product’s sellers list only if it has been allowlisted. Being on the allowlist is what lets a store create an offer against the master product. Without it, the store cannot list that product for sale.
The allowlist link is created automatically for the submitting store when a product is created with seller_ids, and managed afterwards with linkSellersToProductWorkflow. See Allowlist stores.

Category allowlist

Product categories carry the same pattern through the category_seller link. It is a many-to-many association between ProductCategory and Seller that scopes which categories a store is associated with. Manage it with linkSellersToProductCategoryWorkflow.
The allowlist governs the right to sell, not the sale itself. A store on the allowlist still has to create an offer to actually list the product. Allowlisting alone doesn’t put anything on the storefront.