At the moment of writing this article, PayPal Payments Advanced is available only in the US and Canada. For general information on PayPal Payments Advanced, see the PayPal Payments Advanced product page.

To enable PayPal Payments Advanced as a payment method in your X-Cart store:

  1. If you haven’t yet done so, sign up for PayPal Payments Advanced.

    To complete the signup process for PayPal Payments Advanced, you will need a verified PayPal Business account. This means that you will need to either create a new Business account or log in to your existing account and upgrade it to Business.

    To use PayPal Payments Advanced, you will need to set up your credentials for access to Payflow API (The same credentials will be used as your login information):

    • Partner,

    • Merchant login,

    • User,

    • Password.

      The User field can be left blank When you log in to PayPal Manager for the first time; however, to run live API calls, you must specify a user, such as the default admin user. The default admin user has the same name as your Merchant login. We, however, recommend setting up a user login other than your Merchant login as it is more secure and ensures uninterrupted service should you change the password for your Merchant login ID. Thus, to obtain the “User” part of your credentials, you will need to log in to PayPal Manager at and set up an additional user profile for your Business Account.

    Please note your Payflow credentials as you will need them to configure PayPal Payments Advanced in X-Cart.

    Before you start accepting live transactions, you must fill out a short online credit application, which normally takes two days to process. Most applications are approved. If your application is not approved, you can easily convert your account to Payflow Link and connect it with a merchant account from any major processor.

  2. Set up hosted checkout pages and set up PayPal Manager.

    To promote security, be sure to enable Secure Token in your PayPal Manager account.

  3. In X-Cart, add PayPal Payments Advanced to the list of your store’s active payment methods and configure it.

    • Go to the Payment methods page in your X-Cart store’s Admin area (Store setup > Payment methods). Then, in the section for Online methods, click Add payment method:


    • In the popup box that appears, find the method PayPal Payments Advanced and select to Add this method:


    • Once the method has been added, you will be redirected to the settings page for PayPal Payments Advanced. Сonfigure PayPal Payments Advanced settings:


      ‘Your account settings’ section:

      • Partner name: Enter the ID of the partner that signed you up for the account. If you signed up directly through PayPal, this would be “PayPal.”

      • Merchant login: Specify the merchant login name that you chose when you signed up for PayPal Payments Advanced.

      • User: Enter the username that you set up for running transactions. If you have not specifically set up a username to run transactions, this will be the same as the “Merchant login.”

      • Password: Enter the password you created for the user account denoted in the “User” field.

      ‘Additional settings’ section:

      • Transaction type: Specify the type of transaction that you want to be performed on order placement when a buyer pays you via PayPal Payments Advanced ("Auth" or "Auth and capture").

      • Test/Live mode: Set the operating mode for PayPal Payments Advanced (‘Live’ should be selected for live stores, ‘Test’ - for testing). Note that you will need to use test PayPal accounts for testing, i.e., you will need at least one test seller account and one test buyer account. You can set up a test buyer account in the PayPal Sandbox. As to the seller account, for testing, you will need the same Payflow API credentials that were set up when you created your Payflow account (the ones used to log in to; you will also need your Payflow account to be set to work in ‘test’ mode (Depending on what you specified during registration, or how your account was set up for you, your Payflow account may already be in the ‘Test’ state; you need to check the state of your account before you proceed.) A method to link your Payflow account with a test seller account in the Sandbox is provided in the article PayPal Test Account.

      • Order id prefix: Specify your trading name or any other prefix that helps you identify a payment transaction originating from this store. This field is required if using the same PayPal account for more than one online store.

      • Display the “Buy Now with PayPal” button: This setting determines whether or not the “Buy Now with PayPal” button should be displayed on product list pages (in list view) and product details pages.

    • Click Save changes to submit the payment configuration.

    • Make sure the method is active:

      • PayPal Advanced settings page

      • Payments page

Did this answer your question?