Basic Configuration (WooCommerce, Shipping, Payment Gateway, Tax Settings)

A- A+

In the Basic configuration for Dokan, you need to set up the plugin and customize the settings per your needs. This includes configuring the payment options, shipping options, necessary Dokan settings, and the overall look and feel of the marketplace.

Here are the settings that we are going to configure in this doc:

To get started with the basic configuration of Dokan, you will need to have a self-hosted WordPress website, Dokan Lite, a Dokan Pro plugin, WooCommerce, and a payment gateway account.

Once these requirements are met, you can install and activate the Dokan plugin on your website and begin the basic configuration process.

Below is the explanation of each step mentioned above.

Enable Vendor Registration Form

Dokan has integrated the Vendor Registration form with WooCommerce’s Customer Registration form.

By default, the Registration Form is disabled after installing WooCommerce for the first time. So, the form needs to be enabled manually by enabling the “Allow customers to create an account on the “My account” page” option from the WordPress Admin Dashboard > WooCommerce > Settings > Accounts & Privacy screen.

This image shows how to enable vendor registration form from Dokan backend.

After that, a registration form will appear on the “My Account” page, and users need to select the “I am a vendor” option to register as a vendor on the marketplace.

This image shows how Dokan registration form looks like from frontend.

If you want to create a separate vendor registration form, they can create that using the following shortcode:

[dokan-vendor-registration]

That shortcode will create a form like the one below:

This is a screenshot of Dokan Vendor registration form

Also, if you want to remove the “I am a vendor” option from the My Account page, you can add the following code snippet at the bottom of the child theme’s functions.php file.

remove_action( 'woocommerce_register_form', 'dokan_seller_reg_form_fields' );

Note: If you do not have a child theme, you can add the code using Code Snippets plugin.

Dokan follows a specific permalink structure for its default pages. If the proper setting is not followed, it will create a 404 error while visiting those pages. To avoid that error, the marketplace/WordPress site permalink should be /%postname%/, and it can be setup from the WP Admin Dashboard > Settings > Permalinks screen.

This illustration shows how to set up Dokan Permalinks

Necessary Dokan Settings

After installing and activating the Dokan plugin, a Setup Wizard has been triggered by Dokan automatically that contains the necessary settings. If you have skipped that part and want to run again, then hover over the “Question (?)” sign and click on the “Run Setup Wizard” option.

This image shows Dokan necessary settings like Selling options, withdraw options, and so on.

You can read the Dokan Admin Setup Wizard doc for further information.

Setting up Necessary Pages

Dokan has three default pages that are created automatically after activating the plugin. However, if there is any prevention by any plugins/themes, sometimes those pages are not generated automatically.

In that case, those pages may need to be set up manually. You can read the Installed Pages doc contains more information.

Customizing the Marketplace Layout and Design

The layout and design of a marketplace depend on themes. As Dokan is a WordPress plugin based on WooCommerce, you can choose any theme to make a better look and feel for your marketplace. But without proper compatibility, a theme can break the Dokan plugin page's design. So, using a compatible theme on the site is recommended. Here is a list of themes that advertise their theme to be compatible with the Dokan plugin.

Once you have completed these steps, your marketplace should be set up and ready to use. You can then invite vendors to sign up and start selling on your marketplace.

It's important to note that basic configuration alone may not be enough to fully utilize the plugin, and further customization or advanced configuration might be needed to get the best performance of the plugin.

WooCommerce Settings

Dokan Multivendor is based on WooCommerce. It comes with several built-in WooCommerce functions, such as Payment, Shipping, and Tax. These are essential features that you need for the smooth operation of your marketplace. So you need to configure these WC settings to use Dokan properly.

If you are creating an online multivendor store using the Dokan plugin, there are a few things to configure in WooCommerce to make your multivendor platform fully functional. In this documentation, we will walk you through the General settings of WooCommerce and describe different sections from it.

To get started, just navigate to the WooCommerce > Settings section from your WP dashboard.

Store Address

This image shows how to set up Dokan store address

You must have already filled in this information while installing WooCommerce. If not, you won’t probably want to leave it empty as this address signifies where your marketplace is located. It also determines default tax rates and customer locations.

General options

This image shows WooCommerce General options like selling locations, shipping locations, and so on.
  • Selling Location(s): In this section, you can choose whether you are selling to all countries or to specific countries. You can also choose multiple countries at once.
  • Shipping Location(s):  This section lets you select the countries you sell to. You can also disable shipping and all shipping calculations.
  • Default Customer Address: This will help the system calculate tax and shipping based on customers’ – 
  • Shop base address – the customer’s location is the same location as your shop.
  • No location by default – leaves location empty, so no taxes are calculated until the customer provides an address.
  • Geolocate – finds customer’s current location and calculates taxes accordingly.
  • Geolocate with page caching support – same as geolocating, just uses Ajax on top. You may notice your website URLs have a ?v=xxxxx appended to them. This is normal to prevent static caching of prices.
  • Enable Taxes: This allows you to enable or disable taxes on your store. Disabling taxes hides the tax settings page.
  • Enable Coupons: Enable or disable coupons on your store. Coupons can be applied from the admin edit order screen (for unpaid orders), cart, and checkout pages.
  • Enable the use of coupon codes – select to enable the use of coupons in your store.
  • Calculate coupon discounts sequentially – changes the coupon calculation logic to apply coupons in sequence on top of one another. When applying multiple coupons, this will apply the first coupon to the full price and the second coupon to the discounted price, and so on.

Currency options

This illustration shows WooCommerce currency options.

This determines how prices are displayed on the front end. 

  • Currency: You can choose the default currency for the store, one only.
  • Currency Position:  Set the default currency position for prices: Left, Right, Left/Right with space
  • Thousand Separator: Choose the symbol to use for the thousand separators: 1,000 or 1.000
  • Decimal Separator: Choose the symbol to use for the decimal separator: 100.00 or 100,00
  • Number of Decimals: Choose how many numbers to display to the right of the decimal when displaying prices: 100.00 or 100

That’s all. You are done setting up the general WooCommerce settings.

Configure Payment Options

When it comes to handling payments for your Dokan-powered multivendor marketplace, you will need to rely on WooCommerce a lot as functionalities related to payments are mostly controlled by WooCommerce.

To configure different payment methods, go to the WooCommerce > Settings > Payments section from your WordPress Admin Dashboard.

You will find all the installed payment gateways here. The payment methods can be dragged and dropped to control the order, which determines how they appear in front of the customer during checkout.

Also, all the payment gateways will appear on this page when a WooCommerce-supported payment gateway plugin is installed and activated on the site.

This is a sceenshot that shows WooCommerce Payment Gateways

In this documentation, we will show how the default payment methods work. It is important to note that the default WooCommerce payment methods are offline methods, and all of them are non-adaptive.

What is an Adaptive and Non-Adaptive Payment Method?

Dokan supports two types of payment methods. One is adaptive, and the other is the non-adaptive payment method. If an order is placed using an adaptive payment gateway, the vendor earnings and admin commission will be transferred automatically after that.

On the other hand, if an order is placed using a payment gateway that is non-adaptive, the entire order amount will be transferred to the admin account. Vendors can see the value of their earnings from the Vendor Dashboard > Withdraw screen.

Admin can set a minimum withdrawal limit for submitting a withdrawal request. When a vendor reaches that limit, they can send a withdrawal request to the admin. Then the admin needs to transfer/send that amount to the respective vendor’s account based on the request and mark the request as approved to adjust the vendor dashboard earnings value. 

This documentation shows how you can manage vendor withdrawal requests manually.

Direct Bank Transfer

Direct Bank Transfer, also known as Bank Account Clearing System (BACS), is a payment gateway that does not require any online payment to be made during the checkout process.

When customers choose to pay using Direct Bank Transfer, their orders are put On Hold until payment clears outside the website.

As the owner of the site or marketplace, it is crucial to ensure that payments have been successfully cleared from the bank accounts before processing orders in WooCommerce. This verification step is necessary to guarantee that you receive the payment before shipping an order and marking it as Processing or Complete.

To enable this payment method –

  1. Navigate to the WP Admin Dashboard > WooCommerce > Settings > Payments screen.
This image shows WooCommerce Direct Bank transfer option
  1. Click the Finish Set Up button to configure/setup the Direct Bank Transfer payment method.
This image shows WooCommerce Direct Bank transfer option
  1. Configure your settings:
  • Enable/Disable – Enable to use; Disable to turn off
  • Title – Choose the title shown to customers during checkout
  • Description –This will be visible to customers when they choose Direct Bank Transfer
  • Instructions – Explain how to make payment to your bank account(s)
  • Account Details –  Enter the account name and number, bank name, routing number, IBAN, and/or SWIFT/BIC numbers shown to customers on the Order Received page and in Order emails after checking out.

Lastly, Save the Changes.

Note: Bank account details will show on both the Order Received page and the order email sent to the customer.

Order Received page:

This is an image that shows a receipt of bank transaction

This information is also added to the email that is sent to the customer once the order has been received.

This is a screenshot that shows an Order Confirmation page

Check Payments

Check Payments is a payment gateway that does not involve making online payments. When customers choose this option, their orders are put On Hold until the cheque payment clears outside the website.

As the owner of the site or marketplace, it is imperative to ensure that the cheques have been cleared before processing orders in WooCommerce. It is essential to verify that you have received the payment before shipping an order and marking it as Complete.

To enable this payment method – 

  1. Navigate to the WP Admin Dashboard > WooCommerce > Settings > Payments screen.
Check Payments settings
  1. Click the Finish Set Up button to configure/set up the Check Payments payment method.
Check Payments Settings page
  1. Configure your settings:
  • Enable/Disable – Enable to use; Disable to turn off
  • Title – Choose the title shown to customers during checkout
  • Description –Add info shown to customers if they choose Check
  • Instructions – Explain how to pay by Check
  • Save changes

Cash on Delivery

Cash on Delivery (COD) is another payment method that does not involve online transactions. When customers choose this option, their orders are initially set to Processing.

Upon delivery, the payment is collected, and once received, the order status needs to be manually updated to Completed.

To enable this payment method – 

  1. Navigate to the WP Admin Dashboard > WooCommerce > Settings > Payments screen.
Cash on Delivery Settings
  1. Click the Finish Set Up button to configure/setup the Check Payments payment method.
Cash on Delivery Settings page
  1. Configure your settings:
  • Enable COD – Enable to use. Disable turning off
  • Title – Choose the title shown to customers during checkout
  • Description –Add info shown to customers if they choose Cash on Delivery
  • Instructions – Explain how to pay via Cash on Delivery
  • Enable for shipping methods – Choose which shipping methods and rates will offer Cash on Delivery
  • Accept for virtual orders – Tick box to allow COD for virtual products (e.g. orders of a product that is virtual or downloadable)
  • Hit Save changes, and you are done!

Adaptive Payment Gateways

If you use an adaptive payment gateway, the money will be split between you (the admin) and your vendors automatically after the payment for an order is done by the customer. The adaptive payment gateways are available as modules with the premium plans of the Dokan plugin. You can find more information in the following documentation:

Conversely, if you use any of the payment gateways as described above (Direct Bank Transfer, Check Payments, & Cash On Delivery) or any other WooCommerce-supported payment gateways, it will work as a non-adaptive method.

Exception Case

However, there is an exception for the “Cash On Delivery” payment method. It is a bit tricky for marketplaces. Because the payment will be collected by the delivering party. If the admin is delivering the products to the end customer, everything is fine. The admin can keep his commission and send the vendor the rest of the money after delivering an order.
The problem comes when vendors deliver orders. They will collect the whole amount of an order. So, how can an admin collect their commission? To solve this problem, Dokan brought the Reverse Withdrawal feature. You can read about the feature from the Reverse Withdrawal documentation.

Set up Shipping Options

Shipping options configuration is also an essential part of running a marketplace. Here we are going to show you two types of shipping configurations- WooCommerce Shipping and Dokan Shipping

WooCommerce Shipping

The shipping functionality is being handled by WooCommerce. So you are free to use any WooCommerce compatible payment gateways with Dokan. WooCommerce already has some built in shipping gateways, these can only be configured by the admin and will work for each vendor. The vendors will not be able to configure any shipping charges if you use any shipping gateway other than Dokan Shipping.

To know more about how WooCommerce shipping gateway works and how to configure them, please read their official documentation.

You need the Dokan Premium version to activate this feature.

Dokan Shipping

Dokan plugin has the most advanced feature to enable the sellers to add shipping costs from the frontend. Using this feature is optional. If you do not like this feature and want to use the old school WooCommerce shipping classes, then no action is required.

The state based shipping option of Dokan plugin can be found on wp-admin → WooCommerce → Settings → Shipping → Dokan Shipping.

This image shows the Dokan shipping settings from the backend

Click on the enable checkbox and hit save. If you want to apply taxes on then you can select taxable else you can select none.

Please refer to the new Dokan Zone-based Shipping Documentation to figure out the next steps.

The job of the admin is finished here. Now the next job is to the sellers.

Configure Tax Settings

Dokan has built-in support for WooCommerce taxes. So the admin can configure taxes from backend and vendors can select those tax classes while creating or editing the products.

Configuration

Go to wp-admin → WooCommerce → Settings.

Under the Settings page, check the box for Enable Taxes [Enable taxes and tax calculations] under General Options.

This image shows how to enable taxes option from your dokan backend

This will open up a new tab in the Settings page, called Tax.

This image shows how to add tax classes from Dokan backend

In this page, click on Standard Rates and Save Changes. 

This image shows how to set tax rates

Now you can enter the tax rates manually or even Import / Export from CSV files.

Dokan tax settings

You can add reduced tax rates.

Reduced Tax Rates

Or you can add zero tax rates.

Zero tax Rates

Vendor Usage

When you are done setting up taxes, you will have the Dokan tax class listed with the other ones you have.

Navigate to yoursite.com → Dashboard → Product and go to any product edit screen.

The vendor only has to select the tax classes from the drop-down and hit Save. The taxes will be applied to the checkout page automatically.

Doakn tax settings