How To: Set up PayPal Commerce Platform in Multi-Vendor¶

How it Works¶

1. A customer adds a few products from different vendors to his cart.

2. On the checkout page he chooses the PayPal Commerce Platform payment method.

   

3. When the customer clicks one of the buttons, he goes to the PayPal checkout page, where he pays for his order.

4. PayPal automatically splits all the money between the marketplace and the vendors whose products were bought. The marketplace owner doesn’t have to transfer money manually.

Step 1. Configure the Payment Method¶

1. Sign up for PayPal Commerce Platform.

2. Install the PayPal Commerce Platform add-on.

3. Create a new payment method based on the PayPal Commerce Platform processor.

4. Open the Configure tab and fill in the following fields:

   

   • Account settings:

     • Partner integration code—your build notation (BN) code. Contact PayPal team directly using provided email in this section.

     • Merchant account ID, App Client ID, App Secret—these settings connect your marketplace to your PayPal account. Get these credentials from PayPal.

     • Test/Live mode—set to Live to accept real payments.

       The test mode is intended for developers. It works with the special PayPal sandbox instead of live servers. No real money is involved in sandbox transactions.

     • Currency—if you specify the currency that is not the same as the marketplace primary currency, then it will be converted as soon as you go to the PayPal checkout page.

   • Funding sources to show on checkout—choose the payment services you want to be displayed on the PayPal checkout page.

   • Cards to show on checkout—choose the payment cards you want PayPal to accept payments from.

   • Button appearance—choose the shape, color and height of the PayPal button on the checkout page.

5. Click the Create button.

   

Step 2. Have Your Vendors Connect Their Accounts¶

Vendors connect their PayPal business accounts to receive the money for their products that have been sold. If a customer adds products from different vendors to his cart, and all those vendors have their PayPal accounts connected to the marketplace, then this payment method will be offered to the customer.

Here is an instruction for vendors on how to connect their PayPal accounts:

1. Open the Vendors → Vendors page.

2. Click on the vendor’s name to open his settings.

3. Go to the PayPal tab.

4. Click Connect with PayPal.

   

5. You’ll be taken to the PayPal website. Follow the instructions there to connect your account to the marketplace. This will allow you to receive money from orders to your PayPal account without the need to request its withdrawal from the marketplace owner.

6. After you have done everything on the PayPal’s side, you will be redirected back to your store.

7. Click the Save button.