General settings

How the plugin works

For every completed order, the receivers that you’ve previously set will get a percent commission calculated on the order subtotal amount.

Let’s consider, for example, an order worth €100, with 2 eligible receivers, one has a 50% commission rate, the other one has a 20% commission rate.

As soon as the order goes to Completed status, two payments will be issued from the admin PayPal account, the first one is worth €50 and the second one is worth €20.

But let’s see how to configure all the plugin options the right way.

In order to works properly, opcache.save_comments must be set at 1 in php.ini file of your server

Configuration

To start using your PayPal account to pay percent commissions to your cooperators, you first have to configure PayPal Payouts for your shop.

Go to YITH Plugins > PayPal Payouts.

General settings

PayPal business email: enter here your PayPal account email address. This is the account from where payments to the receivers will be issued.

Once you are in your PayPal account, make sure you create a REST API app or use one you’ve already created.

Enter then your PayPal API credentials into the plugin settings. You will find your Client ID and Secret KEY in your REST API app.

Application Client ID: enter here the key you find in under Client ID

Application Client KEY: enter here the key you find under Secret

Enable Sandbox Mode: Enable this option if you want to test this plugin with a sandbox PayPal account first, so no real transaction will be made. If you want to create a sandbox account, please, refer to PayPal official documentation.

IMPORTANT: By default, Payouts is enabled in the sandbox environment. Merchants in the U.S. with a business account can enable Payouts in the live environment. Please, refer to PayPal official documentation for more information.

Enable Log: enable this option if you want to see the error log during debugging. Remember to disable it when your website is regularly running.

Exclude Vendor Product from Payouts calculation: only available when Multi Vendor plugin is enabled. This option allows you to exclude vendor products from Payouts operations. Only products associated with no vendors are eligible for creating commissions for your receivers. Read more about this integration on this page.

Webhook Configuration: here you find the URL that you have to enter in your PayPal account setting in order to make the payments be issued correctly. To set it up, click on Add Webhook in your PayPal account and paste the URL into the Webhook URL there:

Webhook-URL

Then, select all PayOuts events as shown in the following image:

payout-events

Press on Save and you’re done.

Payouts receivers settings

From the plugin settings panel, click on the tab called Payout Receivers Settings to add all the people you want to share profits with.

Make sure the receiver you want to add has already registered to your website, as you can only add existing users to this page.

Click on Add new Receiver, start typing the username and select it. Enter then his/her PayPal Email address, which is where the payments will be sent to. Finally, enter the commission percentage.

Please, note: when you set the commission percentage, make sure it is a reasonable percentage as this commission will be calculated out of the order subtotal, excluding taxes. Yet, every transaction processed by PayPal has fees, so, make sure you consider all the expenses when you set this commission rate.

Payout Receivers Settings

If you want to read more about PayPal commission fees on transactions, please, refer to PayPal official documentation.

Payouts List

In the following section, Payouts List, you will find all the payouts you have issued so far.

They are listed in batches and grouped by order. On the first column, you find the reference order, followed by the Payout Batch ID.

Payouts list

IMPORTANT: Please, consider that the payouts will only be issued when the order status goes to completed.

The third column of the table shows the current status of the payout batch. It can be one of the following:

  • unprocessed: you will see the status when no payment has been made yet and the order hasn’t gone to completed status yet.
  • pending: this is a temporary status that appears when the transaction hasn’t been processed yet.
  • processing: this is the status that the batch payment takes when the payments are being processed.
  • success: the payout batch take on this status when all payments have been correctly issued to all receivers.

Payout Mode column: it refers to the type of payment that is linked to the batch. It can take on the following statuses:

  • Instant: this is the default status you will see when the plugin is used to pay a percentage on every order to all the receivers.
  • Affiliate: this status appears when the Payout payment is related to an affiliate commission generated through YITH WooCommerce Affiliates plugin.
  • Commission: this status appears when the Payout payment is related to a vendor commission generated through YITH WooCommerce Multi Vendor plugin.

Payout Details: click on this button to see the detail of the Payout batch and all transactions included in it.

This is an example of how a batch looks like:

Payout details

There are two payouts listed under the same order because there are two receivers set for shop payouts.

If you use this plugin in combination with Multi Vendor or Affiliates, there might be more transactions in the same batch than the listed receivers.

By clicking on the “eye” icon in the last column of Payout Details, you will get to see a popup with the Payout item details:

popup

Receiver’s transaction list

If the admin can keep track of all the payments issued to the receivers on in the plugin settings in the Payouts List tab, each receiver will be able to check their own payouts on the frontend, in a dedicated section in My Account page.

They will find a menu item called Payouts. Here they find a list with all transactions they have received.

The table includes a reference to the Payout item ID, the Transacton ID, the Transaction status and the amount.

Transaction list on the frontend

Privacy Settings

In order to comply with the GDPR (General Data Protection Regulation), this plugin includes a dedicated tab in the plugin settings. From this page, you can decide what to do with the information managed by YITH PayPal Payouts plugin. Please, refer to

Privacy settings

The first option, Export user’s payouts, allows users to export information about their own payouts when they submit an account personal data export request.

The following section, Personal Data Eraser, allows you to choose what to do when a user submits an account erasure request. You can check the following boxes:

User data: this removes the user’s PayPal email address from your website.

PayOuts: this removes the user’s PayPal email address from the payouts details saved on your website.

For what concerns all the other user information, please, refer to WordPress main page under Tools > Export Personal Data and/or Erase Personal Data.

YITH WooCommerce Affiliates

This plugin allows you to pay all the commissions that are generated by your affiliates if you use the premium version of YITH WooCommerce Affiliates.

In order to enable the two plugins to work together, make sure both of them are installed and activated.

Whenever an affiliate drives a sale to your shop, you will see the list of commissions under YITH Affiliates > Commissions.

Based on the settings of your affiliate payments, the plugin allows manual and automatic payment of affiliate commissions.

1. Manual payment

If you have selected the manual payment of affiliate commissions,  every sale driven by an affiliate to your store will appear as in the following screenshot.

Affiliates - commissions

Next to each commission you will find some buttons that perform different actions. Among them you find the option to pay the commission via PayPal Payouts. Just click on it to pay one specific commission.

As an alternative, you can bulk select more than one commission and process the same action for all of them.

2. Automatic payment

If you have selected the manual payment of affiliate commissions,  every sale driven by an affiliate to your store will appear as in the following screenshot.

Make sure you select PayPal Payouts and all payments will automatically go through it.

Affiliate payments in Payouts list

Once the payment is done, you will also be able to see this payment in your Payouts List. It will be easy to spot the payment of affiliate commission, as they are listed as Affiliate Payment for (followed by the affiliate payment ID) and will take on the affiliate status in the PayOut Mode column.

Payout list with statuses

 

YITH WooCommerce Customize My Account Page

YITH WooCoomerce Customize My Account Page helps you customize your “My Account” page in your website in a few simple step, adding new sections and editing the default WooCommerce ones.

payouts tab

Integrated with YITH PayPal Payouts for WooCommerce the endpoint with PayPal Payout content is automatically added to the my account page.

For more information on how to set up the Customize My Account Page plugin, check the complete documentation here.

YITH WooCommerce Multi Vendor

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 of YITH WooCommerce Multi Vendor is installed and activated.

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 that 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.

YITH Multi Vendor + YITH PayPal Payouts

YITH Multi Vendor allows turning your shop into a marketplace like Amazon or Etsy. Let users apply as vendors, and manage their own products, orders, coupons and sales reports in exchange of a provision on each sale. It’s a win-to-win solution for both the admin and the vendors.

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.

Vendors & Funds

Whenever you activate the two plugins, you will be able to see a dedicated tab in the plugin settings YITH > Account Funds > Vendors & Funds.

This tab includes two sections.

1. General settings

The first one is about the General settings, where you can enable the following options:

  • The vendor can charge funds: this option allows your vendors to charge funds in their online wallet like any other customer.
  • The vendor can use funds: this option allows your vendors to use their funds to purchase products of your shop.

2. Redeem funds

The second section, instead, allows you to configure how vendors can Redeem their funds.

Please, note that all the following features are only available if you are using:

Your vendors will be able to withdraw their commissions’ credit and get paid to their PayPal account. You can enable both automatic payments and/or payments on request.

Let’s start with the first option that apply to both automatic and manual redemption that are listed below:

  • Vendor can redeem: make sure you enable this option to let vendors redeem their available funds. Choose below if you want to enable the automatic or manual redemption or both of them.
  • Minimum funds to redeem: set the minimum balance necessary for a vendor to redeem funds.
  • Maximum funds to redeem: set the maximum funds that can be redeemed in a transaction, leave empty to disable this restriction.
  • Gateway Method: set the gateway to use for transferring funds from the site to the vendor. At the moment only PayPal Payouts is available and it requires YITH PayPal Payouts For WooCommerce Premium 1.0.12 to use this feature. Please, note that you will pay a fee to transfer money from the site to PayPal.

1. Automatic payment

Again in YITH > Account Funds > Vendors & Funds, you have to set up the following option to enable the automatic payment.

  • Automatic Redeem Type: this option allows you to let vendors be paid automatically instead of submitting a payment request every time.
    • None: select this if you want to keep the automatic feature disabled. Make sure you select the manual redeem below to let your vendors submit a request at any time from My Account page (see below).
    • Automatically when the minimum threshold is reached: this way you can issue automatic payments as soon as the minimum amount set above is reached.
    • Automatically, on a specific day and when the minimum threshold is reached: this way you can issue automatic payments on the 1st of the month (or any other day you set) but only for vendors’ accounts that have reached the minimum amount set above. Vendors can however submit a payment request manually if the ‘Manual redeem’ option below is enabled.
      • Redeem Day: choose the day on which issuing the automatic payment, i.e. enter 1 to issue payments automatically on the first of every month.

All transactions will be visible to the vendor in My Account > Transaction History.

And the status of the transaction can be checked in My Account > Payouts.

2. Manual redemption

Alternatively or in addition to the automatic payment, you can also let vendors redeem their available funds manually on request.

Below in YITH > Account Funds > Vendors & Funds, these are the options that you have to configure:

  • Manual Redeem: enable this option if you want to allow also manual redemption and submit a request from My Account. By enabling this option, you will also be able to customize the button text and colour.
    • Redeem Button: customize the label of the button shown in My Account here.
    • Redeem Button Text Color
    • Redeem Button Color

If you enable this option, your vendors will be able to see a dedicated section in My Account > Redeem funds, from where they can submit a request and being paid immediately.

They can enter a custom amount (between the minimum and maximum allowed if you’ve set up these values in the settings) and as soon as they send the request the payment will be processed through the gateway that you’ve selected (only YITH PayPal Payouts available at the moment).

The payment will be will be recorded in the Transactions History.

The transaction status will be available in My Account > Payouts and the admin can check the transaction in PayPal Payouts > Payouts List > Details.

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