The integration with YITH WooCommerce Multi Vendor 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 WooCommerce Multi Vendor and configure your marketplace as explained on the official documentation of Multi Vendor plugin. 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.
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:
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.
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.
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:
- The charge amount less the Stripe fees is added to the platform account’s pending balance
- 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
- The platform retains an additional $6.80 ($100.00 – $70.00 – $20.00 – $3.20, assuming standard U.S. Stripe fees).
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.
It may happen for three reasons that you have commissions unpaid:
- You haven’t enabled any default payment method (the option Pay commissions to vendors during checkout has been set to Disabled)
- Your account did not have enough funds to pay all commissions.
- 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.
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:
Please, consider that only vendors who have a VAT number can use a Stripe account on live websites.
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.
Please, refer to Stripe official page for any details about the payments and transaction fees.
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.
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.