YITH Account Funds

YITH Account Funds allows all users to have a virtual wallet for their purchases. Users make a deposit and the amount gets converted in virtual funds that can be used to purchase from your store, avoiding any kind of transaction before the purchase.

The integration with YITH Account Funds allows you to issue vendors’ payouts into their digital wallet, by simply crediting the amount in their account funds.

To enable this integration, you just have to make sure that both plugins are installed and enabled from the Plugins page.

Then, make sure you enable the Account Funds payment method in YITH > Multi Vendor > Gateways > Account Funds

And you will see this gateway enabled in Gateways > General settings.

Now, if you want to automatically credit the vendors’ commissions to their account funds, please, make sure you select it as the default gateway in Gateways > General settings > Pay commissions to vendors during checkout.

If, on the other side, you don’t want this to be the default method, but use it manually, you can simply leave those settings unchanged. When you have to issue a vendor’s payout to the account funds, you can do that from the Commissions page, by simply clicking on the Account Funds button next to it.

Once processed, it will appear in the Paid list.

For more details about the configuration of YITH Account Funds, please, refer to the full documentation here.

How the admin can create vendors’ orders from the backend

The admin or shop manager can create orders for vendors from the admin area. When creating the order, the plugin will check the products added and will automatically assign them to the related vendors, if any.

After creating the order, the vendor commissions will be calculated accordingly.

Gutenberg

The plugin is ready to use with the new Gutenberg editor. When you add a new post or page, you will be able to find our YITH shortcodes and widgets. With a simple click they will be added to your page.

Multi vendor gutenberg

YITH PayPal Payouts

You can use YITH PayPal Payouts for WooCommerce to pay your vendors’ commissions instantly and automatically.

To start using it, make sure that the premium version both plugins are installed and activated.

Configure YITH PayPal Payouts on your shop as explained on this page.

Then, go to the plugin settings under YITH Plugins > Multi Vendor > Payments.

Here you will find all the available payment gateways that you can use to pay vendors’ commissions.

Click on PayPal Payouts to enable it and make sure you save the changes.

You can now choose whether to pay commissions to vendors automatically during the checkout and pick the payment method you prefer among the available ones.

Open the dropdown next to Pay commissions to vendors during checkout and pick PayPal Payouts.

This way, all commission payments will go through it automatically.

If, on the other side, you prefer paying commissions manually, just select Disabled on Multi Vendor payment settings page:

You will see the pending commissions in the Commissions page and the available payment method right next to it. Click on PayPal Payouts in the Actions column to pay the commission through it.

Exclude vendors’ products from Payouts commissions

If you want to avoid thta vendors’ products are included in the total calculation for your store’s receivers commissions, we suggest you keep this option enabled.

Go to YITH Plugins > PayPal Payouts and make sure it is checked.

Suppose you get an order with 2 products. Product A belongs to vendor A and costs €60, product B does not belong to any vendor and costs €40, so the total order is worth €100. In addition to this, you have set one receiver with a 50% commission.

If the option is disabled, your receiver will get €50.

If the option is enabled, product A is excluded, so the receiver will get €20, which is 50% of product B price.

If you want to read more about Multi Vendor configuration settings, please, refer to the official plugin documentation.

How to pay commissions using PayPal Masspay

Please note: since PayPal MassPay is no longer supported it cannot be activated on new users’ accounts.
Yet, users who had previously activated PayPal MassPay service can keep using it to manage payments automatically and can refer to the following information for the configuration.

To pay commissions by PayPal MassPay you must configure the requested guidelines in Gateways > PayPal section of plugin settings dashboard.

PayPal MassPay Options

For automatic payments, the vendor has to decide whether to receive the commission immediately or only after reaching a certain threshold that they can set up. To do that, they can go to their Vendor Profile > Payments.

Set payment treshold by vendor

The threshold can’t be lower than the one set by the administrator in YITH Plugin > Multi Vendor > Gateways > Minimum Withdrawal €

PayPal MassPay Options (1)

In order to let PayPal payment system work correctly you must insert the following information:

  • API Username
  • API Password
  • API Signature

Enter your PayPal API credentials to process refunds via PayPal. Learn how to access your PayPal API Credentials here.

In the end, in order that the plugin can receive a notification when the payment from PayPal took place, don’t forget to copy and paste the guideline in “Notification URL” of your PenPal account.
Go to your PayPal SandBox account and click on Profile and Settings > My Selling Tools > Instant Payment Notification.

PayPal options

Click on Edit Settings and copy the URL specified in the plugin.

Sanbox PayPal account

Sanbox PayPal account

PayPal MassPay is now a deprecated service. The service has been restricted to only users who had the service enabled.

If you already have an approved account, you will be able to use the service with Multi Vendor plugin.
On the contrary, please, consider that Mass Pay can no longer be activated and the only available method for vendors’ payment is manual payment.

Please, consider that the admin is charged all transaction fees. For more details about the fees, please refer to PayPal official page.

How to pay commissions using Stripe Connect

Stripe Connect

The integration with YITH Stripe Connect for WooCommerce allows the admin to split the price of one or more products between the vendor and the admin immediately after the checkout and based on the commission rate that you’ve agreed with them.

First of all, make sure you’ve downloaded and installed the premium version of YITH Stripe Connect for WooCommerce. Enable YITH Stripe Connect for WooCommerce from Plugins menu.

Configure it as explained on the page Connect admin account from the official plugin documentation.

Then, go to YITH Plugins > Multi Vendor > Gateways > Stripe Connect and click on Enable Stripe Connect to activate the service for your vendors.

Enable Stripe Connect

Make sure you set the redirect URI in your Stripe account. A warning message in the plugin settings panel will remind you about this and will show you the right address to add. It will look like this:

Redirect URI

Configure the URI from Stripe Connect dashboard.

The URI that you have to add to make Multi Vendor work correctly is not Stripe default URI, but an additional one. This means that if you remove the default one, the button Connect Stripe in My Account page will not work. Make sure, then, you do not remove it.

Redirect URI

Now, go back to General Settings section, and select the default payment gateway to use on checkout page for all payments. If you just have Stripe Connect, you’ll be able to see this one only, but if you have other compatible gateways enabled, you’ll be able to choose among all of them.

Choose default gateway

This is the gateway that will be used by default.

How do payments on checkout work?

Stripe provides a detailed description of what the whole process is about. You will find this explained in the plugin options panel under YITH > Multi Vendor > Gateways and can refer to Stripe official page for further details.

Send Money to vendor on payment completed
When creating charges on your platform and separately creating a transfer, the platform can earn money by allocating less of the charge amount to the destination Stripe account, as in the above code example. Assuming that represents a delivery service transaction, with a charge to the customer of $100, a transfer of $20 to the delivery person, and a transfer of $70 to the restaurant:

  1. The charge amount less the Stripe fees is added to the platform account’s pending balance
  2. When the platform’s available balance is sufficient (at least $90), the transfers can be made, reducing the platform’s available balance by the specified amounts and increasing both connected account’s available balances by that same amount
  3. The platform retains an additional $6.80 ($100.00 – $70.00 – $20.00 – $3.20, assuming standard U.S. Stripe fees).

Stripe payment details

Fees for the payment of commissions are charged to the admin. Please, refer to this page to learn more about transaction fees.

Payments on the backend

If, for any reasons, the payment of vendor commissions fails, or if there is no default payment gateway enabled, you’ll be able to use any of the supported payment methods to pay vendor commission on the backend list of commissions.

Methods available

It may happen for three reasons that you have commissions unpaid:

  1. You haven’t enabled any default payment method (the option Pay commissions to vendors during checkout has been set to Disabled)
  2. Your account did not have enough funds to pay all commissions.
  3. Your vendors haven’t activated their Stripe account yet.

Let’s see how to solve this latter issue.

What to do on Vendor side

Because of Stripe policy, every vendor has to explicitly authorize Stripe to be credited any payment to his/her account.

Note: this action can only be performed by the vendor and there is no way for the admin to do this on his/her behalf.

Make sure your vendor goes to their own Vendor Profile > Payments and click on the button Connect with Stripe.

Connect with Stripe

They will be taken to Stripe site. If they already have an account, they can simply log in. If they do not have any yet, they will be asked to create a new one:

account-stripe

Please, consider that only vendors who have a VAT number can use a Stripe account on live websites.

Vendors will be able to see the very same button in their reserved area, My Account and will be able to export all transactions concerning their own commissions.my account - stripe connect

After the vendor has authorized Stripe account to receive money, you can go on and pay the commissions from the Commissions page.

Click on the button Stripe Connect that you find next to the commission line. If you click on that button, the commission will be automatically paid to the vendor through your Stripe account.

Pay from Commissions page

Please, refer to Stripe official page for any details about the payments and transaction fees.

Commission reports

If you want to, you can choose to show all vendor commissions generated to Stripe reports. Go to YITH Plugins > Multi Vendors > Gateways and check the option Add vendors’ commissions to Stripe Connect Commission Report. 

Commissions in Stripe reports

All commission payments gone through Stripe Connect will appear in your Stripe Connect Report that you can also find under YITH Plugins > Stripe Connect > Commissions.

paid commissions

Order synchronization

Order synchronization allows you to update the parent order and suborder (also more than one suborder) status automatically if editing one of them.

Orders can be synchronized when:

  • the parent order status changes
  • the suborder status changes
  • both previous cases

Let’s learn about how the synchronization manages the order status change.

Parent-suborder synchronization

The suborder updates automatically when the parent order status changes, acquiring the same status.

To let the synchronization work correctly, that you activate the option “Parent-suborder synchronization”, which you can find in the tab “Vendors” of the plugin settings dashboard.

order management

Suborder-parent order status synchronization

The parent order updates automatically when the status of one of the suborders changes.

To activate this synchronization, enable the entry “Suborder-parent order status synchronization”.

Suborder-parent syncronization

How is the parent order status set when the suborder status changes? 

  • If all suborders are set as completed, the parent order acquires the completed status
  • If all suborders are set as refunded, the parent order acquires the refunded status
  • If all suborders have the completed and refunded status (related to a partial refund of the parent order), the parent order status is set as completed 
  • If suborders have different statuses, the parent order acquired the processing status. 

Please note: if the parent order has only one suborder, both order statuses are always perfectly synchronized.

 

Show live chat icon

To open the live chat, you can also use the related icon available in the social network list.

The icon shows only with the following conditions:

  • YITH Live Chat is active
  •  YITH Live Chat add-on is enabled in Multi Vendor plugin
  • Vendor inserted the value #yith-live-chat in the entry Vendor Profile -> Frontpage -> YITH Live Chat.

Enable live chat icon

Enable shipping module for vendors

If you want to allow vendors to manage shipping costs, it is essential to enable the option “Enable shipping module” you can find in the “Add-Ons” section of the plugin settings dashboard.

Enable shipping module

How and where can vendors edit the shipping settings? 

The shippings must be configured in Vendor Profile -> Shipping.

Shipping options for vendor

In this section, they must configure the following options:

  • Default Shipping Price: amount added by default when the cart includes at least one product
  • Per Product Additional Price: amount added when the cart includes an additional product different from the one previously added
  • Per Qty Product Additional Price: additional amount for each product of the same type added to cart
  • Processing time: average time spent to process and ship the orders. It’s showed on product detail page (with shipping and refund policy)
  • Shipping and Refund Policy: information showed to user inside the product detail page
    Shipping information
    Note: The administrator can edit the label of “Shipping info” tab through the option “Shipping Info Tab” available in the tab “Front page” of the plugin settings dashboard.
  • Shipping from: country where vendor’s shop is located

The last step is the configuration of shipping zones and related methods.

Set shipping areas

HOW-TO-USE SAMPLE

To resolve any possible doubt about shipping costs applied to cart, we provide an example.

Checkout page

In this case, the shipping cost configuration is as follows:

  • Shipping method (flat rate): €100
  • Default shipping price: €10
  • Per product additional price: €5
  • Per qty product additional price: €1

The cart total is calculated as follows:

€100 (default amount of the shipping method “Flat rate” for the product vendor )
+
€10 (a one-time amount added if at least one product is in the cart)
+
€5 (amount due for the second product added to cart. If adding 3 products, the amount would be €10)
+
€4 (€1 for each additional copy of the product added to cart. In the sample, 4 copies)

Total: €119

How to switch to vendor from admin panel

The plugin allows the administrator to switch to the vendor’s dashboard.

To apply the switching, it is essential to have the User Switching free plugin installed and enabled.

Now, go to Vendors and click on the entry Switch to for the related vendor.

Switch to