Marketplace Merchant feature overview

Edit on GitHub

Merchant is a seller of goods or services, either a business or a private person working in the Marketplace environment. Merchants manage their business in the Merchant Portal. The Merchant Portal allows merchants to upload and manage merchant products and offers, define prices and stock, fulfill orders, and edit merchant profile information. Merchant can have employees who can access the Merchant Portal and perform actions on the merchant’s behalf there. These employees are referred to as merchant users.

Merchant is the core entity of the Spryker Marketplace and the second main entity after customers since the Marketplace connects the buying customers and the selling customers. Every merchant in the Spryker Marketplace has a unique identifier in the system called Merchant SKU.  You can create merchants in the Back Office or import merchants.

Note

After you created a merchant, you can not delete it completely. You can only deactivate the merchant.

Merchant statuses

The Marketplace administrator manages merchants and sets their statuses in the Back Office. Merchant statuses define the level of access of the specific merchant to:

  • The Merchant Portal:
    • Waiting for approval. Once the merchant record is created, this status is applied.
    • Approved. Once the record is approved, the merchant receives an email with the password information required to access the Merchant Portal. When the merchant is approved, merchant users can log in and create offers and products in the Merchant Portal.
    • Denied. A Marketplace administrator can deny access to the approved merchant. If denied, the merchant cannot log in to the Merchant Portal.

  • The merchant profile page, product offers and merchant products on the Storefront:
    • Active. This status can be set only for the approved merchants. It indicates that the merchant’s profile page is online, and the merchant can create offers and products. A merchant can also create offers and products and manage their sales activity.
    • Inactive. This status indicates that the merchant’s profile page, products, and offers are offline. It is the default status for the created merchant. With this status, the merchant can not perform their selling online.
STATUS MERCHANT PORTAL ACCESS STOREFRONT PROFILE PAGE, OFFERS, AND PRODUCTS
Waiting For Approval N/A
Approved N/A
Denied N/A
Active N/A
Inactive N/A

See Approving and denying merchants and Activating and deactivating merchants for details on how to change the merchant user statuses and (de)activate merchants in the Back Office.

Schematically, the merchant status change flow looks like this:

Merchant status flow

Merchant category

You can group merchants by categories to make your working process more efficient and simplify merchants search for customers. See Merchant Category for details.

Merchants on the Storefront

Merchant profile

On the Storefront, customers can check the relevant merchant information on the Merchant Profile page.

Note

The merchant profile page is available only if the merchant is Active .

The information for the merchant profile can be defined:

Viewing merchant profile

Merchant opening hours

To make the selling activity efficient, merchants can provide their working schedule that will display to buyers on the Storefront. See Merchant Opening Hours feature overview for details.

Marketplace Storefront allows buyers to check what merchants are the owners of the offers and products the customers are buying. The respective merchant names with the link to the merchant profile page are available:

  • On the product detail page

Merchant link on the PDP

  • On the cart page

Merchant link on the cart page

  • On the summary checkout page

Merchant link on the summary checkout page

  • On the order details page

Merchant link on the order details page

Searching and filtering by merchant name

In the Spryker Marketplace, you can search for the products sold by a specific merchant by entering the merchant name in the search field. The search results contain the merchant products and/or the abstract products the merchant product offers are related to. The search suggestions and the auto-completion functionality provide the merchant products and offers by the merchant name. Search by merchant name

In the catalog and search results pages, there is the merchant multi-select filter. This filter allows shoppers to see only the products with the product offers belonging to the selected merchant. See Standard Filters documentation for more details on the filters available in the Spryker Commerce OS.

Merchant search filter

If the merchant is not active, their products and offers are not displayed in the search suggestions, search results and in the merchant filter.

Next steps

Learn about the merchant users

FEATURE OVERVIEWS MERCHANT PORTAL USER GUIDES BACK OFFICE USER GUIDES
Merchant users overview Editing merchant’s profile details Managing merchants
Main merchant concept Managing merchant users
Developer guides

Are you a developer? See Marketplace Merchant feature walkthrough for developers.