Back to Top

Prestashop Marketplace PayPal Commerce

Updated 10 May 2024

Payments are an integral part of an eCommerce website. An ineffective payment mode can cost you sales & those figures can be really high. Nowadays, customers are concerned about payment security & their personal data more than ever. They really like to use the payment mode that is able to provide these features undoubtedly. Hence, we are here with one such module to provide your customers with enough payment security. And, that is none other than Prestashop Marketplace PayPal Commerce module. This module will help your sellers to accept the payment via PayPal from the customers.

Apart from the useful features of the module, the significance of payment disbursal modes can not be stressed enough. the module empowers admin with basically two types of disbursal modes i.e. Instant and Delayed.

In case of Instant mode, the seller gets the money as soon as the customer makes the payment. Whereas in case of Delayed, the amount is held by admin & he/she can make the payment as per their suitability.

In the eCommerce domain, the refunds happen way too often. Hence, to make the process easier, admin gets the functionality to manage the refunds as well. Now, without losing any more minutes, let’s see each of the useful features of the module in detail.

Features of the Prestashop Marketplace PayPal Commerce module

  • A new payment method is added to the store.
  • Use the module either in the sandbox or live mode.
  • The payment distribution occurs on the basis of commission setting configuration.
  • Admin can easily manage the refund from his end.
  • Make partial as well as a full refund to the customer.
  • The module supports both instant & delayed payments disbursement mode.
  • In order to receive the payment, a seller must onboard to PayPal.
  • View list of all the sellers who onboarded PayPal.
  • The list of all the PayPal transactions is also available at the admin’s end.


Searching for an experienced
Prestashop Company ?
Find out More
  • Prestashop Marketplace PayPal Commerce module is MultiShop Compatible with PrestaShop Advanced Multi-Vendor Marketplace version 5.4.0/3.4.0 and above.
  • Prestashop Marketplace PayPal Commerce module is compatible with PrestaShop version 8.x.x.


  • PayPal Commerce Platform is currently available to approved partners. In order to use this module, you must have verified PayPal Business account and zero wallet balance and no further transactions in the account.
  • Also, fill the PayPal Commerce Platform – Questionnaire to provide information about your business model.
  • A customer can checkout with a maximum of 10 sellers in the cart. And, each seller can have multiple products.

PayPal Commerce Platform (PCP) is currently available in the following countries:

US, Australia, Belgium, Bulgaria, Cyprus, Czech Republic, Denmark, Estonia, Finland, France, Greece, Hungary, Italy, Latvia, Liechtenstein, Lithuania, Luxembourg, Malta, Netherlands, Norway, Poland, Portugal, Romania, Slovakia, Slovenia, Spain, Sweden, United Kingdom, Canada, Austria, Germany, Ireland.

Here is the link to the video in which I explained the process to fill out the questionnaire form.

How to install the Prestashop Marketplace PayPal Commerce module

In order to install the module, you need to install the PrestaShop Advanced Multi-Vendor Marketplace module first.

After installing the marketplace module, you can now proceed to install the Prestashop Marketplace PayPal Commerce module.

  • Firstly, go to the module manager in the back office and click on ‘upload a module’.
  • After that, drag and drop the module file or select the file from the system.
  • In this way, the module installation will be successful.
Click to upload Prestashop Marketplace PayPal Commerce module
Drop or select Prestashop Marketplace PayPal Commerce file
Prestashop Marketplace PayPal Commerce module installed on prestashop

Steps to get the client ID & client secret

In order to configure the module, you will need to obtain the client ID, client secret & merchant ID.

Firstly, visit the PayPal website. After that, proceed to login into your Paypal account.


Enter your login credentials to proceed.


After successfully logging in to the account, go to the “My Apps & credentials” section. Now, click on the ‘Create App” button.


Enter the name of your app & click on the “Create App” button.


After clicking on the button, API credentials will be generated. View your client Id & client secret here on this page.


Now, to get the merchant ID, firstly go to the accounts section.


Under accounts section, find the account for which you want to get the merchant ID. After finding the account, click on the three dots button available against the account name. Now, click on the “View/edit account” button to proceed.


After clicking on that button, following popup with account details will open. Here, you can find your merchant ID.


To find the merchant ID of your PayPal account for live mode, log in to your PayPal account at After that, click on the Settings icon, Navigate to Account Setting and click on Business information, and look for PayPal Merchant ID

So, this was all about the process to get the API credentials for the module.

How to configure the Prestashop Marketplace PayPal Commerce module

After getting the API credentials, fill it out in the configuration settings of the module. Apart from the API credentials, there are some other options too in the configuration setting. So, let’s understand their use quickly.

Disbursement Mode: Choose whether you want to disburse the seller amount instantly or after some time. If you choose Instant, the sellers receive the payment instantly as the customer makes payment and places the order.

In case, if you choose ‘delayed’ then you would need to disburse the amount manually from your PayPal account. Moreover, if funds are not disbursed within 28 days, they are automatically disbursed to the seller.

Enable PayPal on checkout by default: Enable to make the PayPal Commerce Payment a default payment mode.

Title: Enter the name of the payment method which you want to show at the checkout page.

Configure Prestashop Marketplace PayPal Commerce

So, this was all about the process to configure the module.

Seller onboarding process

In order to let your seller accept the payment via PayPal commerce, you first need to onboard the seller to PayPal. For this, a new tab adds to the Seller dashboard.

Seller's dashboard

After clicking the tab, a seller needs to select the country to proceed.

select country to onboard seller

Now, click on the “Enable PayPal“button. On clicking the button a popup will open.

Enable Paypal onboard

Here, a seller needs to fill the email ID & the country to proceed.

Login to PayPal account

After that, a seller needs to login into his/her account.

Login to PayPal account

Now, a seller needs to agree to the terms in order to connect the account to admin PayPal account.

Agree to terms and conditions
Seller onboarded successfully

In this way, seller onboarding process to PayPal is now complete. And, seller can accept payments via PayPal commerce payment method.

setup complete

After the successful onboarding to PayPal, name of the seller will display in the “PayPal Seller onboarding” list at admin end.


Click on the View button to view the details of seller & the PayPal merchant ID.


This was all about the process to onboard the seller to PayPal.

Note: A seller must confirm his primary email on PayPal after completing the onboarding process.

Ordering process

In case of delayed payments

After adding the product to cart, a customer can proceed to checkout.


Here, a customer can choose to pay via credit/debit card or by logging in to the PayPal account.


After clicking on the PayPal button, a popup opens. Now, a customer can login into his/her account to proceed.


Either select a suitable saved payment method or add new payment mode to pay for the order.


After making the payment successfully, a customer lands on the order confirmation page. The PayPal order id is available on the order confirmation page too.


At the PayPal end

After the confirmation of payment, admin can check the payment in their PayPal account. To check the payment, go to Activity then All transactions.


As this was a delayed payment, so you can see that status of both of these are on hold.


The details of transactions along with their status are also available at the admin end.

List of all PayPal transactions made by customer

On clicking the view button, you can view the transaction details. From here, you can also release the payment of seller which is currently on hold.


A popup will open to confirm about the same. Click on OK to proceed.


After the confirmation, button text will change to “Seller amount released“. You can also click on view button to see the details.


A popup containing the details of release of payment.


After releasing the payment, it will be updated at PayPal end too.


In case of instant payments

In the case of instant payments, the payment goes directly to the seller account. It does not hold into admin’s PayPal account.

The process is same like it was with delayed payments.

Firstly, add the product to the cart & proceed to checkout.


Select the payment method & proceed.


After that a popup opens to login to the PayPal account. A customer can fill in the credentials to proceed.


Then select a suitable saved payment method or else add a new one to make the payment.


After the payment confirmation, customer lands on the order confirmation page.


At the PayPal end

A new entry of the payment is visible at the PayPal end too.


On viewing the details of transaction, one may easily find the status as ‘Completed“. As it was an instant payment, hence the amount directly goes to the seller account.


An admin can find the entry of the transaction at his/her end too.

Paypal transactions

In viewing the details of the transaction, admin can easily notice the disbursal mode as “Instant“. Even in this case, admin can refund the amount in the same way which was discussed earlier.


After that, an admin can also see the transactions at PayPal. And it will show “Bank Settlement” in Activity Section.


Just for clearing the doubts, let’s see a simple case to understand the distribution of shipping charge between seller and admin.

Suppose a customer adds two products of different seller in the cart. And, the product price of both sellers are as follows:

Seller 1 product price = 50

Seller 2 product price = 100

Total Amount = 150

Total shipping charge = 10

Order Total = 160

Now, the distribution in this module is based on the following formula.

(Seller 1 price / Total Amount) * 100 = % of shipping charge (for seller 1) => (50/150) * 100 = 33.33

(Seller 2 price / Total Amount) * 100 = % of shipping charge (for seller 2) => (100/150) * 100 = 66.66 ~ 66.67 (round off)

Hence, the shipping charge for both sellers would be something like this:

Shipping charge for seller 1 = (% of shipping charge (for seller 1) / 100) * Total shipping charge => (33.33 / 100) * 10 = 3.33

Shipping charge for seller 2 = (% of shipping charge (for seller 2) / 100) * Total shipping charge => (66.67 / 100) * 10 = 6.67

And the final distribution would be something like this:

Seller 1 product price + Shipping charge for seller 1 = 50 + 3.33 => 53.33

Seller 2 product price + Shipping charge for seller 2 = 100 + 6.67 => 106.67

Refund process

Now, let’s see the process of refund & how it reflects in PayPal account afterwards. Firstly select a refund type, whether its partial or full refund. After that, enter the amount & click on the refund button.


On making the refund, a new entry adds to the refund list along with the details.


The admin can also see the seller-wise refund list on the order details page.


And, at the PayPal end, two new refund history add to the list. The first is the reversal of PayPal fee & the second is for refund.


An important note:

Additional reports for the partners:

Partners can subscribe for the additional reports as given below link.  Please refer the link for more details on reports.

How to Create a SFTP account:

In order to know more about the process to create SFTP account, please follow the link.

This was all about the Prestashop Marketplace PayPal Commerce Module. I hope this document will help you in checking the functionality of the module in a better way. Also, do let us know about your views in the comments.

In case, if you are looking for another PayPal module that instantly splits the payment between seller and admin. Then do check out the blog.


For any kind of technical assistance or query, please raise a ticket at or send us a mail at [email protected]

Current Product Version - 4.1.2

Supported Framework Version - 8.x.x, 1.7.x.x

Blog Version - 8.x.x, 1.7.x.x
  • Version 8.x.x, 1.7.x.x
  • Version 1.7.x.x
. . .

Leave a Comment

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

Be the first to comment.

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