Payouts

Click here to purchase Payouts

Minimum Requirements

Payouts requires PHP 5.6+ and the following plugins:

  • WC Vendors 1.9.14+
  • WooCommerce 3.0+

In order to accept payments from your customers, you’ll also need a payment gateway. For the best experience, we recommend a gateway that supports refunds. The PayPal Standard gateway that ships with WooCommerce is a great option.

Prerequisite – Obtaining PayPal API Credentials

Please note, access to the “Live” Payouts API must be approved by PayPal.  Before purchasing we suggest applying for access from PayPal to ensure you will be able to utilize Payouts in your home country

Payouts requires valid PayPal REST API credentials to function. If you don’t have credentials already, this video will guide you through the process of obtaining them.

Enabling Live Payout Transactions

One you have created your PayPal Developer account, you will need to enable Live payouts.  This step does not need to be completed in order to send payouts in Test mode, but before you can process any live payouts, you will need to have this option enabled.  Keep in mind that this process is not instant.  Once you click “Enable,” it can take up to 48 hours for approval.

To enable live payouts:

  1. Log into your developer.paypal.com account.
  2. Navigate to your Dashboard.
  3. Click My Account on the left hand menu.
  4. Find Payouts on the list of PayPal products, and click Enable.

5. You will be presented with a short questionnaire.  Simply fill that out and submit it.  PayPal will then contact you when you have been approved.

Installing Payouts

To install Payouts:

  1. Log into your WordPress site.
  2. Go to Plugins > Add New.
  3. At the top of the screen, click Upload Plugin.
  4. Select the .zip file sent to you in your Purchase Confirmation email. You have two options:
    1. Click Browse. Find and select the plugin .zip file.
    2. Drag and drop the .zip file onto the Upload Plugin screen.*
  5. Click Install Now.
  6. When the installation completes, click Activate.

* Drag and drop will only work if your browser supports it!

Activating Your License

To benefit from future updates to Payouts, you must activate your license key. To do so:

  1. Log into your WordPress site.
  2. Go to Plugins.
  3. Find the row for WCV Payouts.
  4. Click activate license.
  5. Enter your license key, which was delivered along with your download.
  6. Click Activate.

Admin Settings

This section will walk you through the settings available for Payouts. To get started, find the WCV Payouts row on the Plugins screen and click Settings.

Test Mode

Check this box to enable test mode. In test mode, all payouts are sent in the PayPal Sandbox; no live payments will be processed.

Pay Commissions

Choose how and when to pay commissions. There are four options available:

  • On a fixed schedule – Pay all due commissions on a daily, weekly, bi-weekly, or monthly basis.
  • Manually – Pay commissions on your own schedule.
  • When orders are marked as shipped – Pay a vendor’s commissions when they mark their part of an order as shipped.
  • When orders are paid for – Pay vendor commissions when payment for an order is received.

You can always make manual commission payments, even when the Manually option is not selected. See Creating a Payout Manually for more information.

Payment Schedule

This option appears when Pay Commissions… is set to On a fixed schedule. It determines how often commission payments are sent:

  • Monthly – Pay due commissions once monthly, starting on the first of next month.
  • Bi-weekly – Pay due commissions every other week on the last day of the week.
  • Weekly – Pay due commissions every week on the last day of the week.
  • Daily – Pay due commissions once daily at the end of the day.

The last day of the week is determined using the Week Starts On setting. You can find this under Settings > General > Week Starts On.

Hold Duration

This option appears when Pay Commissions… is set to When orders are marked as shipped or When orders are paid for. It controls how long payouts are delayed after an order is shipped or payment is received. Examples of valid values include “1 month,” “2 weeks,” and “3 days.”

If you wish to send payouts immediately, simply leave this field blank.

Fee Payer

Choose who pays the PayPal fees on each payout. There are two options:

  • Marketplace – The marketplace pays the PayPal fees.
  • Vendor – The vendor pays the PayPal fees; the projected fees are deducted from the amount sent to the vendor.

Payout Fee

Use this option to charge vendors an extra fee for each payout. You can enter a fixed fee, a percentage fee, or a fixed + percentage fee. Examples of valid values include “0.25,” “2.5% + 0.25”, and “2.5%.”

If you don’t want to charge a payout fee, simply leave this field blank.

Fees Charged By PayPal

Some of the most common questions we get involve the fees paid to PayPal while using the Payouts plugin.  There are two distinct PayPal transactions when using PayPal as both your payment gateway, and the means to pay your vendors, and each will incur a PayPal fee.  The initial transaction, where the customer submits payment on your site will incur the traditional PayPal transaction fee.  After the initial transaction, when you generate a vendor payout, there will also be an additional PayPal fee, based on the vendors location.  The sender pays Payout fees at transaction time. Fees vary by country, are calculated as a percentage of each transaction, and are capped. Typically, the variable component is 2% and the domestic payments cap differs from the international payments cap. For detailed information about payout fees, see the PayPal Merchant Fees and How are fees for Payouts calculated and reported?.These fees are important to keep in mind when determining the commission structure of your marketplace, and that is why we have built in the ability to easily mitigate them via your Payout settings.

Live Client ID

This option appears when Test Mode is disabled. You should enter the Client ID listed under Live API Credentials when you edit your PayPal application.

Live Secret

This option appears when Test Mode is disabled. You should enter the Secret listed under Live API Credentials when you edit your PayPal application.

Sandbox Client ID

This option appears when Test Mode is enabled. You should enter the Client ID listed under Sandbox API Credentials when you edit your PayPal application.

Sandbox Secret

This option appears when Test Mode is enabled. You should enter the Secret listed under Sandbox API Credentials when you edit your PayPal application.

Managing Payouts

Payouts are created in one of three ways. The Type of a payout indicates how it was created:

  • Manual – Created manually by an Admin.
  • Scheduled – Created as part of a regular scheduled payment.
  • Event Based – Created when an order was marked as shipped or paid for.

Each payout is assigned a unique ID at the time it is created. In addition, a Batch ID is assigned when the payout is submitted to PayPal for processing.

A payout also has a Status. The status reflects the progress of the payout and ranges from Pending Approval to Complete. The following payout statuses are used:

  • Pending Approval – Created, but not posted to PayPal – admin approval is required.
  • Scheduled – Scheduled for a future date – no further action is required.
  • Pending – Posted to PayPal and awaiting processing.
  • Processing – Payout is being processed by PayPal.
  • Complete – Payout completed successfully – no further action is required.
  • Canceled – Canceled by PayPal – see payout notes for more information.
  • Denied – Denied by PayPal – see payout notes for more information.

The payout fees are estimated until its status transitions to Processing. This fee schedule is used to compute fee estimates.

Viewing Payouts

As payouts are created, the Payouts page will start to fill up. You can find this page under WC Vendors > Payouts (WC Vendors 2.0+) or WooCommerce > Payouts (WC Vendors 1.9.14).

Each row displays details about a single payout, including its ID, the date it was created, the number of payments in the payout, the amount you will pay from your PayPal balance, and the payout’s progress.

Payouts with failed, blocked, returned, or denied payments are highlighted in orange so you can quickly identify them. Hovering a payout’s progress bar reveals details about the progress of the payout.

You can Filter payouts by Date (month/year), Type, and Status.

If a payout is Pending Approval, you can choose to Approve or Decline it from the payouts list table.

Clicking the payout ID or the list icon will open the payout details screen. This screen shows the payments included in the payout and the commission totals paid to each vendor.

By clicking the “eye” icon in the Total Commission column, you can view the orders and items comprising the vendor payout.

To get a high level overview of the status of the payout, you can toggle the Show Details option off.

As payouts are processed, issues may arise. For example, some payments might be blocked or denied by PayPal, or returned after they go unclaimed by the recipient. In order to help you catch these issues, Payouts includes a Notifications system.

You can view unread notifications from the Payouts screen by clicking on the bell icon.

Clicking on the notification text will open the relevant payout. You can dismiss a single notification by hovering over it and clicking the X icon. Alternatively, you can Dismiss all unread notifications at once.

The number of unread notifications is displayed next to the Payouts menu item so you can quickly determine whether there are issues that need your attention.

Creating a Payout Manually

You can create a Manual payout using one of four methods:

Method 1: Create Payout Page

  1. Go to WC Vendors > Payouts (WC Vendors 2.0+) or WooCommerce > Payouts (WC Vendors 1.9.14).
  2. Click Create at the top of the page. The Create Payout page will open.
  3. Select the commissions you wish to pay.
  4. Click Create.

Method 2: Commissions Page

  1. Go to WC Vendors > Commissions (WC Vendors 2.0+) or WooCommerce > Commissions (WC Vendors 1.9.14).
  2. Check one or more due commissions.
  3. Select Pay with Payouts from the Bulk Actions menu.
  4. Click Apply.

Method 3: Users Page

To get started, go to Users > All Users.  From there, you will have the option to pay Multiple Vendors or a Single Vendor.

Pay Multiple Vendors

  1. Check one or more vendors with due commissions.
  2. Select Pay due commissions from the Bulk Actions menu.
  3. Click Apply.

Pay a Single Vendor

  1. Hover the vendor you want to pay.
  2. Click Pay commissions.

Method 4: Orders Page

  1. Go to WooCommerce > Orders.
  2. Check one or more orders with due commissions.
  3. Select Pay due commissions from the Bulk Actions menu.
  4. Click Apply.

After creating a payout, you will be directed to the Payout Review page. Here, you can review the details of the payout before submitting it to PayPal for processing.

Clicking Show Payments reveals a table with details about the individual payments that will be made as part of the payout. Generally, there will be one payment per vendor being paid.

Click Pay Now to submit the payout to PayPal, or Cancel to delete it and return to the previous page.

Handling Refunds

Payouts implements a cooperative refund process to help recover refunded commissions from vendors. The process kicks in when you use the Refund button to fully or partially refund an order.

The Cooperative Refund Process

To initiate a cooperative refund:

  1. Go to the Single Order page.
  2. Click Refund.
  3. Input the quantity of each item to be returned, as well as any additional fees that may have been charged.
  4. Click Refund manually or Refund via Payment Gateway.

If the commissions for the refunded item(s) have not been paid, the refund will be processed immediately. Otherwise, Payouts will delay processing of the refund until all paid commissions have been returned.

Here’s what happens behind the scenes:

  1. Invoices are sent to each respective vendor for commissions paid on refunded items.
  2. The customer receives an email indicating that their refund is processing.
  3. If the order was fully refunded, its status is changed to Pending refund.
  4. After all vendors have paid their invoices, the refund is processed automatically via your payment gateway*. If the order was fully refunded, its status is changed to Refunded.

* If you processed the refund manually, you will be responsible for processing the refund via your payment gateway.

Managing Refunds

Cooperative refunds can be managed from the Single Order page, just like normal WooCommerce refunds.

The Status Labels beneath the refund details summarize the status of the cooperative refund. Hovering them reveals more detailed information.

A list of vendors who were invoiced is displayed under Invoices Paid. Vendors who have paid their invoices are marked with a green check, and those who haven’t a red x. Canceled invoices are indicated with strikethrough text.

Click Process now to process the refund via your payment gateway immediately, or Cancel unpaid invoices to cancel all unpaid invoices.

Click here to purchase Payouts

Updated on January 28, 2019

Was this article helpful?

Related Articles