Back to Top

WooCommerce Marketplace PayPal Commerce

Updated 23 January 2024

WooCommerce Marketplace PayPal Commerce: This module provides the customer with one of the most secure and sought out payment methods. Since this module is associated with PayPal so the payment is split between seller and admin dynamically.

PayPal is one of the most trusted payment methods worldwide, which allows its customers to transfer money online. And, it ensures a secure money transfer to the seller account.

The admin can easily make the refunds for the payments. The module provides two different disbursement mode which is Instant and Delayed.

The customer can make the payments using the Marketplace PayPal Commerce and proceed to checkout. For this, it is a must for the customer to have an active account with PayPal.

Note: This module is now compatible with WooCommerce’s new High-Performance Order Storage (HPOS) feature.

Start your headless eCommerce
Find out More

Watch the below video tutorial to understand the extension workflow:



  • To integrate this module, one must install the   WooCommerce Multi Vendor Marketplace Plugin first.
  • For integrating PayPal Commerce into WooCommerce Marketplace Mobile App, paid customization work will be needed, contact sales.
  • Please fill and provide information about your business model in the PayPal Commerce Platform – Questionnaire.
  • As of now, a customer can make payments using PayPal for mere seller’s product only similarly only those shipping methods will work which are provided by the seller. 
  • The module does support multi-seller functionality as of now.
  • Every seller needs a unique PayPal Connect account if they use the same PayPal account duplicate merchant Id error will show.


  • The admin enables the Paypal Payment Method for the customers.
  • The client and the secret key is to be retrieved for configuring the payment method.
  • The admin receives the commission based on the sellers.
  • Also, this plugin supports Instant and Delayed payment Disbursement Modes, i.e. PayPal Commerce.
  • To enable Paypal services, the seller must authenticate with PayPal.
  • The payment gets split between the seller and the admin.
  • Admin can process an online refund for the customers.
  • Admin can configure option for admin product checkout or not by Paypal Payment Method.
  • Seller can delete its PayPal merchant account.



The user can easily install the plugin after purchasing it. The user will get a zip file to upload in the add new plugins menu option in the WordPress admin panel.

Meanwhile, the user will navigate through the “Plugins >Add New” and click the “Add New” menu option as per the snapshot below.


After this, you will see an option on the top of your page that says “Upload Plugin”, click the option to upload the zip file.


By clicking on the “Upload Plugin” option, the user will now click on “Choose File” click on the button to browse for the zip file as per the snapshot below.


After browsing the file, click the “Install Now” button to install the plugin as per the snapshot.


Now when the plugin is installed correctly, the user will see the success message and an option to activate the plugin. Hit “Activate Plugin” to activate the plugin.

Marketplace PayPal Commerce

That is all for the installation part of the WooCommerce Marketplace PayPal Commerce Payment.

Create API Credentials for PayPal Commerce

For using this module in the most efficient manner, one must have an active PayPal Commerce Account. To register with the PayPal Commerce Platform the user must go to PayPal Commerce Platform Onboarding Page.

Thereafter, the user will click on the Contact us button as visible in the image below or tap on the link PayPal Partner Form.


After that, the user will navigate to the PayPal Partner Form Page and enter all the field details. After accepting the Privacy Policies of PayPal, the user will click on the submit button.


Further, the user will be able to see a thank you message on the success page if the details are exact and correct. After this, the customer will sign in to their account.


For signing in to the account, the user will go to the link to log in. Thereafter, a PayPal login form will be visible. Here the user will enter the email ID and the password.


Eventually, the user will now navigate to the My Apps & Credentials > Create App under the dashboard section.

Marketplace PayPal Commerce

After that, the user will enter the application details like App Name and select the Sandbox Business Account.

Marketplace PayPal Commerce

Further, by clicking on the Create App button the user will navigate to the next page where all the credentials are mentioned.


Hence, copy the client ID and secret key and configure them in the admin backend under Paypal Marketplace Payment Gateway configurations.

The user can easily generate a new Secret Key by tapping on the Generate New Secret button under the secret field, which will be visible with the date of creation for that particular secret.

Note: Always, it is important for the user to save the original secret key, as the maximum number of client secrets for a user is two.

Module Configurations

After the installation, the admin will proceed to configure the WooCommerce Marketplace PayPal Commerce Plugin by navigating to WooCommerce > Settings > Payments.

Further, the admin will enable Marketplace PayPal Commerce for receiving the payment using this particular payment method.

Meanwhile, the user will click on the Manage button for configuring the module.


After that, the admin will enter the necessary details for configuring the module as shown in the image below:


Details for Marketplace PayPal Commerce includes the following fields:

Enable/ Disable: The admin can Enable or Disable the payment method.

Allow Admin Product Checkout: Now the admin can enable or disable their product checkout.

Title: The admin will enter the title visible to the user during the checkout.

Description: The admin will enter the description visible to the user during the checkout.

Note To Payer: This note will be visible to the payee in PayPal Commerce Transaction details.

Environment: Here, select the mode from the dropdown menu Live or sandbox. Please note the PayPal Environment specifies whether you want live transactions or not.

Display At Top: This set to yes will display the PayPal payment at the first over checkout.

Disbursement: The PayPal Disbursement specifies whether you want Instant payment or Delayed.

Payment From Applicable Countries: Select all countries or allow only specific i.e Payment from Applicable Countries.

Payment Specific Countries: Worked if Payment from applicable countries is set as Payment Specific Countries.

In the Testing/Sandbox and Live credentials please simply enter all the requested details. 

Attribution Id (bn-code): Paypal sends on the mail id that the admin adds while creating an account with PayPal. 

Merchant Id and Account Email: The admin must follow the given path to gather the Merchant and the Account Email.

Finally, click the button Save changes.

Also, please note that PayPal REST APIs uses webhooks for event notification. Therefore, using the Generate Webhook users configure a webhook listener and subscribe it to events.

Paypal Partner:

Step 1: Log in to PayPal Developers Account.

Path: Thereafter, navigate through- SandBox Account > Account Name > View/ Edit Account > Account Details

In the Account Details page, the admin will find the Email ID or Account Email and the Account Id or the Merchant ID as shown below.


Environment: The admin selects the transaction type as Sandbox or Live.

Disbursement: PayPal Disbursement specifies whether the admin requires Instant or Delayed payments.

Client Id: The admin receives it after creating an account with Paypal.

Client Secret Key: The admin receives it after creating an account with Paypal

Seller End Workflow In Marketplace PayPal Commerce

Forthwith, on the seller dashboard simply click the tab PayPal Seller Onboard. 


Post which the user needs to complete the PayPal seller onboard. Here select the country and click Process onboarding.


Once, done now the seller will have to click the button Connect to PayPal.


Further, the seller needs to log in using their PayPal account credentials if already have an account or else they can register.


Finally, After completing the above steps the seller can check that they are now connected as shown in the below image.


Note: Now the sellers can delete their PayPal account.

Placing Order For Single Seller Product

For placing an order, the customer will add the desired product to the cart. Once all the products are added the customer will proceed for checkout as shown in the image below.


After that, the customer will navigate to the checkout page for adding the Billing Details.

After adding the details, the customer will select the Marketplace PayPal Commerce payment method and click on Place Order.

This module is now compatible with WooCommerce’s new High-Performance Order Storage (HPOS) feature.

The customer will then navigate to PayPal’s payment page directly if their PayPal account is logged in as shown in the image below.

Otherwise, a login page will appear after placing the order from where they can simply log in.


On the Payment Page, the customer can either select any card or add a new debit or credit card.

After selecting the card, the customer will click on the Pay Now button for completing the payment.

After the successful payment, the customer will navigate to Success Page which says the order has been received.

This page also displays the order details and billing address as shown in the image below.


Once the orders are completed, they will be visible to the admin for this navigate to WooCommerce > Orders.

Disbursement Mode

The module provides two different disbursement modes that can be used by the admin in order to share the payment between the seller and the admin. These two modes are Instant and Delayed which are described further in the user guide.


If the admin selects the disbursement mode as Instant then the payment will get transferred to the seller and the admin, just after the order is placed.

After the completion of the order, the seller will be able to see the transaction in their PayPal account. 

Marketplace PayPal Commerce webkul-woocommerce-marketplace-paypal-disbursement-instant-



Whereas, if the admin selects disbursement mode as Delayed then the payment will get hold at PayPal’s end. After that, the admin will release that amount and it will get transferred to the seller and the commission transferred to the admin account.

For processing the delayed payment, the admin will set the mode to Delayed by following the path WooCommerce > Settings > Payments and the admin will select the Disbursement as Delayed.


After that, the seller will check the order list and set the order status to Completed by navigating to WooCommerece > Orders as shown in the image below:


Once the order status is completed for the specific order, then that specific order will be visible in the Release Money section. From here, the admin will click on the Release button for the specific order.


Once the amount is released, the Transfer status for that order will change to Paid as shown in the image below:


The transactions are reflected in the seller’s PayPal account. once the payment is released to the seller



Refund Process In Marketplace PayPal Commerce

The module allows the admin to process the refund for the orders from the backend. For this, the admin will navigate to the WooCommerce > Orders.

Select the order for which the refund needs to get generated. After that, click on the Refund button.


Further, the admin will select the Refund via Marketplace PayPal Commerce as shown in the image below:


Finally, the refund report will be visible as shown in the image below:


After the completion of the refund, the amount gets deducted from PayPal’s account too.

Marketplace PayPal Commerce 


Print Invoice In Marketplace PayPal Commerce

The Payment Method will be visible in the invoice slip too as shown in the image below:

Marketplace PayPal Commerce 

Multi-seller Purchase in Marketplace PayPal Commerce

The customers can add the products from multi-seller into the cart and can make payments using the PayPal payment method.


Post which the customers can check order details. As the multi-seller purchase feature do works now.

Hence, the placed order id will remain the same for both the sellers whose product purchased.

Further, the respective sellers can only check information regarding the product purchased by them and will have the same order ID.

Admin Product Checkout

Now the customer can easily check out the admin products as you can check the below image.


That’s all for the WooCommerce Marketplace PayPal Commerce Plugin, still, have any issue feel free to add a ticket at [email protected]

Current Product Version - 2.2.0

Supported Framework Version - WordPress Version: 6.4.1 , WooCommerce Version: 8.3.1

Blog Version - WordPress Version: 6.4.1 , WooCommerce Version: 8.3.1
  • Version WordPress Version: 6.4.1 , WooCommerce Version: 8.3.1
  • Version WordPress Version: 6.2.2 , WooCommerce Version: 7.8.0
  • Version WordPress Version: 5.8.0 , WooCommerce Version: 5.5.1
  • Version 3.9.x
. . .

Leave a Comment

Your email address will not be published. Required fields are marked*


  • Shubham Sharma
    • Jyotsna Gautam (Moderator)
  • Andrew
    • Goldy Bhargava (Moderator)
  • Back to Top

    Message Sent!

    If you have more details or questions, you can reply to the received confirmation email.

    Back to Home

    Table of Content