Multi Vendor Marketplace

1. Download the multi-vendor-marketplace.zip file from your WooCommerce account.

2. Go to: WordPress Admin > Plugins > Add New and Upload Plugin with the file you downloaded with Choose File.

3. Install Now and Activate the extension.

More information at: Install and Activate Plugins/Extensions.

• By Default, users with an existing account on the site can submit a Vendor Application. If you wish to prevent existing users on the site from Vendor Applications, you can do so by disabling the Allow Logged-In Users to Register as Vendor option.
• By default, logged-in users with Customer userrole will be allowed to become a Vendor. If you wish users with other userroles to become a vendor, you can do so by customizing the Allowed Logged-In User role to become a Vendor.
• If you want guest users to submit a Vendor Application, you can do so by enabling the Allow Guest to Register as Vendor option. When this option is enabled and the user submits a Vendor Application, an user account will be created for the user.
• By default, the Site Admin will have to manually review the Vendor Applications and approve it, If you wish to automatically approve Vendor Applications, you can do so by disabling the Vendor Application Should be Approved by Site Admin option.
• You can optionally remind users to accept the terms & Conditions and Privacy policy when it is updated by enabling the Remind Vendors to Accept the Terms & Conditions and Privacy Policy when Updated option.

In this section, you can customize Product and Order Capabilities for your Vendors.

In this section, you can customize which details about the Vendor should be displayed on their Vendor Profile which is visible to buyers.

• By default the Admin Commission will be calculated once the order status reaches “Completed” status. If you wish to calculate the Admin Commission on a different status, you can do so by customizing the Calculate the Admin Commission when the Order Status Reaches option.
• By default the Admin Commission will be calculated from the Vendor’s First Order. If you wish to customize this behavior, you can do so by customizing the Admin Commission is Calculated option. The following customization are possible,
  • From Vendor’s First Order
  • After Vendor Reaching Specific Number of Orders
  • After Vendor has Earned more than a Specific Amount
  • If Vendor’s Product Price is more than a Specific Amount
• In the Admin Commission is Calculated option, if an option other than the From Vendor’s First Order is chosen, the Threshold value has to be configured in the Commission Criteria Value option.
• The Admin commission can either be set as a fixed or a percentage value in the Admin Commission Type option.
• By default, the tax cost paid by the buyers is sent to the Vendors. If you want the Site Admin to receive the Tax Amount or if you want to split tax amount between the Site Admin and the Vendor, you can do so by customizing the “Tax Calculation” option.
• By default, the admin commission value will be calculated on the price after applying the Admin created coupons. If you wish to change this behavior, you can do so by disabling the “Calculate Commission after Applying Admin Created Coupons” option.
• By default, the admin commission value will be calculated on the price after applying the Vendor created coupons. If you wish to change this behavior, you can do so by disabling the “Calculate Commission after Applying Vendor Created Coupons” option.

To enable PayPal Payouts for paying the Vendors, enable the “Enable PayPal Payouts” option.

The credentials for PayPal Payout integration can be obtained from developer.paypal.com

• Log in to your account.
• Dashboard -> My Apps & Credentials
• Select Create App button.
• Provide the required information in Application Details Form[App Name which is to be unique name, Business Account Email Id] and select Create App button.
• Once you successfully created the Application Id, you will get API CREDENTIALS for both Sandbox as well Live.
• Fill in the obtained credentials.

• When an user purchases a Vendor’s product, the amount paid by the user will be sent to the Admin’s account. The Vendor can receive their amount in the following ways,
  • Admin Manually Pays the Vendor.
  • Vendor Submits a Withdrawal Request and Admin Manually Approves the Request.
  • Vendor chooses their Payout frequency and the plugin will automatically pay the Vendor as per the configured schedule(Works only with PayPal).
• In your site if you wish your Vendors to submit for a Withdrawal Request/Allow Vendors to choose the Payout frequency, enable the Allow Vendors to Request for a Withdrawal option.
• The Multi Vendor Marketplace plugin supports two payment methods for paying the Vendors.
  • Bank Transfer: The Bank Account details will be provided by the Vendor. The Site Admin will have to pay the Vendors outside the site and Mark the payment as complete within the site.
  • PayPal: The Vendor is required to provide a valid PayPal ID. The Site Admin can pay the Vendors directly from their PayPal account without leaving the site.
• In the Payment Method(s) for Withdrawal option select your preferred Vendor Payment method(s) which should be displayed to the Vendors.
• By default, Vendors will have to submit a Withdraw request to receive funds. Optionally you can allow Vendors to receive their funds automatically on a predefined interval by enabling the Enable Automatic Withdraw Method option.
• In the Automatic Withdrawal Options option, select the withdraw frequency which should be displayed to the user.
• You can optionally set a Minimum Commission Amount to withdraw in the Minimum Commission Amount to Submit Withdrawal Request option.
• By default, the Vendor Payments will be processed only after 7 days of order completion. If you wish to customize duration, you can do so by customizing the Allow Withdrawal Request After option.
• You can optionally charge a fee from your Vendors for withdrawing their money. To enable this option, enable the Enable Charge for Withdraw Request option and configure the fee.

If you wish to allow your Vendors to manage their shop on your store by adding additional staff staff members, you can do so by enabling the Allow Vendors to Create Staffs for Managing their Shop option.

If you wish to allow multiple vendors to sell a same product, you can do so by enabling the Enable Single Product Multiple Vendors Settings option.

Troubleshoot Settings

• When the plugin is installed for the first time, the pages listed below will be created. In case if the pages were not created/got deleted accidentally, the site admin can create those pages by clicking the Create Pages button in the Create Default Pages option.
  • Vendor Registration: Registration form for the user to submit the Vendor application.
  • Vendor Login: Login form for the Approved Vendors to login to their dashboard.
  • Stores: Stores of all the Approved Vendors will be listed here.
  • Dashboard: Vendor Dashboard page for the Vendors.
• When the plugin is installed for the first time, few database tables will be created in your site’s database on behalf of the plugin. If due to some reason, the tables were not created, the plugin may not function properly. In order to verify all the needed tables are installed without any issues, please click the Verify Database Button in the Verify Base Database Tables option.
• If you wish to no longer use the plugin and wish to delete all the data recorded by the plugin, you can do so by enabling the Delete All Vendor Data upon Uninstall option.

Default Pages

In this section, you can change the default pages of the following,

• Vendor Registration Page
• Vendor Login Page
• Stores Page
• Vendor Dashboard Page
• Terms & Conditions Page
• Privacy Policy Page

Stores Endpoint

By default, mvr-store will be used as the store’s endpoint. If you wish to customize the store slug, you can do so by customizing the Single Store Slug option.

Dashboard Endpoints

The following endpoints can be customized in the Vendor Dashboard,

• Products
• Add new product
• Edit product
• Orders
• View Order
• Coupons
• Add new coupon
• Edit Coupon
• Withdraw
• Add Withdraw Request
• Transactions
• Customers
• Duplicate
• Payments
• Payout
• Profile
• Address
• Social Links
• Staff
• Add Staff
• Edit Staff
• Reviews
• Store Notification
• Store Enquiry
• Store Enquiry Reply

You can customize the labels displayed to the users in this section.

You can customize the messages displayed to the users in this section.

• Vendor Application can be submitted by 2 types of Users,
  • Guest Users
  • Users with an Existing Account on the Site

• To submit a Vendor Application, the users will have to visit the “Vendor Registration” page on the site and fill in the form and submit it.
• Upon Submission, the user will be required to fill in additional details. After filling in the additional details, the site admin will be notified about the new Vendor Application.

• To review the Vendor Application, the Site admin will have to visit the “Vendors” section in the Multi Vendor menu.
• To review and respond to an application, the Site Admin will have to click the Edit link.
• The Site Admin can review the submitted details in this section.
• By default, the Admin Commission Rate is set to the Global settings. If you wish to set a separate Commission Rate for a particular Vendor, you can do so by setting the “Commission From” option to “Custom”. Upon setting the “Custom” option, the all the Admin Commission settings which was available on the Global level will be available on the current Vendor. The value set here will apply only for this vendor.
• After reviewing the details submitted by the Vendor, If the Site Admin chooses to approve the application, they can do so by selecting “Active” in the “Vendor Action” section.
• Once the Vendor is Approved, they will be notified by email and dashboard notification.

• To create new Products, the Vendor will have to visit the Products section on the Vendor Dashboard and click on the “Add new Product” button.
• After that, the user can fill in the Title, description, price, inventory, etc like a normal product creation by the admin in the backend.
• Once all the details have been filed, the Vendor will have to click the Save button. The Site Admin will be notified via email about a new product submission. The Site Admin will have to review the product and make any changes as per their preference and publish the product.

• To create new Products, the Vendor will have to visit the Coupons section on the Vendor Dashboard and click on the “Add new Coupon” button.
• After that, the user can fill in the Title, description, discount type and value like a normal coupon creation by the admin in the backend.
• Once all the details have been filed, the Vendor will have to click the Save button. The Site Admin will have to review the coupon and make any changes as per their preference and publish the coupon.

• The users can purchase products from vendors like a Admin run WooCommerce store.
• The main difference between a Admin run store and a Vendor run store is that in the Vendor run Store, the Vendor Name with a link to the Vendor Profile will be displayed on the Shop Category and Product Pages.

By default, Vendors are eligible to receive payment 7 days after successful order completion. To process the vendor payment, navigate to the Withdrawl Requests section in the plugin menu

Supported Payment Methods

1. PayPal Payouts

• The Site Admin can pay the vendors directly from the site. To pay for a single withdrawal request, the site admin will have to click the Make Payment button on the table.
• To make payment for multiple requests, the site admin will have to make payment using the Generate Payout option.
• Upon clicking the button, the admin will have to select PayPal in the Payment Type option.
• You can optionally filter the Payout Requests to specific dates using the date range filter.
• Upon clicking the Generate Payout, button, the Vendors will be paid from the Admin’s Account.

2. Bank Transfer

• The Site admin will have to pay the Vendors outside the site and update the info on the site. To make payment, the site admin will have to generate a CSV file using the Generate Payout option.
• Upon clicking the button, the admin will have to select Bank Transfer in the Payment Type option.
• You can optionally filter the Payout Requests to specific dates using the date range filter.
• In the Status to be generated option, select the value as “Pending” and click Generate Payout.
• Once the Payout file is generated, click on the Export button on the Withdrawal Requests table. Upon clicking, a CSV file will be downloaded. The file will have all recipient bank details and the amount to be paid.

1. Manual Request

The Vendor will have to submit a withdrawal request. The Site Admin will review and process the request.

Supported Payment Methods

PayPal and Bank Transfer

2. Automatic Payments

The Vendor will be automatically paid based on the configured schedule.

Supported Payment Methods

PayPal and Bank Transfer(Only Request will be automatically created. Payment will have to be manually paid by the site Admin).

• If a Vendor wishes to duplicate a product which is already available on the site, then the vendor will have to access the Duplicate section on the Vendor Dashboard and click on the Duplicate button next to the product name which the vendor wishes to duplicate.
• Upon clicking the Duplicate button, the product will be duplicated, the vendor can customize the product as per their wish and submit it to the admin for approval.
• Once the Product is approved, the Vendors associated with the product will be listed on the product page. The customer can choose from which vendor they would like to purchase.

Multi Vendor Marketplace is translation ready, meaning you can edit the po files by which you can translate the text to any language. Steps to perform the translation are as follows. For example, a translation to French.

• Download and install Poedit
• Open the file multi-vendor-marketplace > languages > multi-vendor-marketplace.pot using Poedit.
• Create a new translation file by clicking Create new translation button.Choose the Source text and set its corresponding French text in Translation Text Area.
• Save the changes.
• Save the file name as multi-vendor-marketplace-fr_FR.po.
• Then go to WordPress dashboard > Settings > General and select the Site Language as French.