Like all PayPal payment methods, the method ”PayPal for Marketplaces” is enabled by the add-on PayPal. So please make sure the PayPal add-on is installed and enabled:

To add the payment method ”PayPal for Marketplaces” for your store:

1. In your store’s Admin area, go to the payments listing page (Store setup > Payment methods) and click Add payment method:


2. In the list of payment methods that opens in a popup window, locate the method “PayPal for Marketplaces” and click the Add button opposite its name:


3. Once the payment method has been added, configure its settings:


Your Account Settings:

  • PayPal For Marketplaces account email: Specify your e-mail registered for PayPal for Marketplace account.

  • PayPal API Client ID: Specify your login to PayPal sandbox or live account.

  • PayPal API Secret: Specify your password for PayPal sandbox or live account. Sandbox accounts are used for testing purposes only. Live accounts are used to process live orders.

  • PayPal Partner ID: Specify the Partner’s business account log-in.

  • PayPal BN Code: Specify a unique build notation (BN) code you’ve got from PayPal as a Partner. If you do not have a BN code, contact your PayPal account manager. BN codes provide tracking opportunities within the PayPal system on all transactions originating or associated with a particular Partner (for revenue sharing).

Additional Settings:

  • Payment descriptor: The payment descriptor on the buyer's credit card statement of account activity.

  • Test/Live mode: Payment method operation mode.

  • Order id prefix: A prefix added to the IDs of all the orders originating from this store to make them unique. This value is required only if you use your PayPal account with more than one store.

  • Disburse funds: Select ‘Delayed’ if you need an option to authorize the earnings transfer to the vendor’s account and ‘Immediate’ if no pre-authorization is required.

4. Save your configuration settings

You can connect an additional PayPal Business Account to your X-Cart if required:


Click the Connect to PayPal link to access the PayPal sign-in page and sign in using your PayPal account, different from the account specified above in your account settings. This additional account will be used to receive the shipping cost (if you are going to ship out goods on behalf of vendors), the earnings on your own products (if you are going to be one of the sellers), and the earnings on the sales of the vendors who have not set up a PayPal Business account of their own for some reason.

If this option is not configured and there is a vendor with a not configured PayPal Business account, a customer will not be able to pay orders via PayPal for Marketplaces payment if a product from such vendor is added to the cart.

5. Make sure the new PayPal for Marketplaces payment method is active.

  • Check the payment settings page

  • Check the payment methods list


Once the above steps have been completed, shoppers at your store should select this method at checkout and use it for payment. By default, the name of this payment method will appear to shoppers simply as “PayPal”:


When hitting the PayPal button to pay for the order, a customer will be redirected to PayPal for payment processing, where they will need to submit the credit card details:


After the payment is complete, the customer will be redirected back to your X-Cart store, and the same payment method name will appear on the order invoice:


If necessary, you can adjust the display name of this payment method (the one that will be visible to customers) and the position of this payment method in your store’s list of payment methods as described in Managing Payment Methods.

Did this answer your question?