Marketplace Merchant feature overview
Edit on GitHubA 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 lets merchants 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.
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 marketplace 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 | ✗ |
For details about how to change the merchant statuses and activate or deactivate merchants in the Back Office, see Create merchants.
Whenever a merchant is denied, all the users (/docs/pbc/all/merchant-management/202404.0/marketplace/marketplace-merchant-feature-overview/merchant-users-overview.html) of this merchant get deactivated. Upon re-approval, the merchant users must be manually activated one by one.
Schematically, the merchant status change flow looks like this:
Merchant category
You can group merchants by categories to make your working process more efficient and simplify merchants’ search for customers. For details, see Merchant Category.
Merchants on the Storefront
Merchant profile
On the Storefront, customers can check the relevant merchant information on the Merchant Profile page.
The merchant profile page is available only if the merchant is Active.
The information for a merchant profile can be defined:
- By the Marketplace administrator in the Back Office when creating merchants or editing merchants.
- By importing the merchant profile data. For more information, see File details: merchant_profile.csv and File details: merchant_profile_address.csv.
- By the merchant in the Merchant Portal:
Merchant opening hours
To make the selling activity efficient, merchants can provide their working schedule that will display to buyers on the Storefront. For details, see Merchant Opening Hours feature overview.
Merchant links on the Storefront pages
Marketplace Storefront lets buyers 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
- On the cart page
- On the summary checkout page
- 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 marketplace products and/or the abstract products the merchant product offers are related to. The search suggestions and the auto-completion functionality provide the marketplace products and offers by the merchant name.
In the catalog and search results pages, there is the merchant multi-select filter. This filter lets shoppers see only the products with the product offers belonging to the selected merchant. For more details about filters available in the Spryker Commerce O, see Standard Filters documentation.
If the merchant is not active, their products and offers are not displayed in the search suggestions, search results, and the merchant filter.
Next steps
Learn about merchant users
Related Business User documents
OVERVIEWS | MERCHANT PORTAL USER GUIDES | BACK OFFICE USER GUIDES |
---|---|---|
Merchant users overview | Editing merchant’s profile details | Create merchants |
Main merchant concept | Create merchant users |
Related Developer documents
Thank you!
For submitting the form