How do I setup Paypal Website Payments Pro (with Paypal Express)?


As of Shift4Shop version 10.2.10, this variant of PayPal is no longer available for selection. The information here is being provided solely for stores that may still have this PayPal variant currently installed.

For instructions on setting up the newest version of PayPal (a.k.a PayPal Checkout), please click here.

This article will show you how to integrate PayPal Payments Pro (with PayPal Express) into your Shift4Shop account.

When you integrate PayPal Payments Pro on the store, PayPal Express will also display on your website. If you would like to integrate PayPal Express on its own (without PayPal Payments Pro) click here.

Here's a brief description of the differences between PayPal Payments Pro and PayPal Express so you're aware of how they each behave.

  • PayPal Payments Pro
    This account will not redirect the customer to PayPal to accept payment. The transaction is completed on your website and the payment method displays as credit card fields.
  • PayPal Express
    This payment method displays as a PayPal logo and opens up a pop up for the customer, allowing them to log into the PayPal website to complete the transaction. Due to PayPal standards, this logo displays on checkout step 1 or prior. This way, the customer does not have to type in their personal information twice (once on your site and once on PayPal's site).

Grant API Access

You will first need to Grant API Access to your Paypal Payments Pro account settings. To do this:

  1. Log into your PayPal Account
  2. Click on the user icon (located toward the top right)
  3. Then click on the "Account Settings" option within that menu
  4. On Account Settings page, locate API access and click on the "Update" link.

On the following page, You will be given several API options. In this case, you will be using the one labeled "Pre-built payment solution.

  1. Click on the "Grant API permission" link.

  1. In the provided box, enter ""
  2. then click "lookup"

PayPal's interface will refresh and show you a list of all possible permissions available to the API.

  1. Check all boxes except for the two mentioned below.

There are two permissions that are not available and will need to be left unchecked. They are labeled "Generate consolidated reports for all accounts" and "Create and modify accounts, and run reports on them" respectively.

  1. After selecting the checkboxes, click the "Add" button (located below the checkboxes) to grant API access.

API access is now granted for your PayPal account.

Next we will set up your Payment Module in the Shift4Shop store.

Insert Your Payment Method

  1. Once you have granted API access in the PayPal console, log into your Shift4Shop Online Store Manager.
  2. Using the left hand navigation menu, go to Settings >Payment
  3. Once in the Payment page, click on the "Select Payment Methods" button

This will take you to the area of the Online Store Manager where you can add or review your store's payment modules. Along the top of the page, you will see pre-installed payment modules within a section labeled "Recommended Payment Solutions." Further down the page you will see a section labeled "Payment Methods" where you can manually install payment modules.

  1. Look towards the top right of the Payment Methods section and click on the "Add New" button.

A small popup window labeled "Add New Payment Method" will appear with your preliminary settings.

  1. In the Payment Method field, scroll down to the "Alternative Payments" section and choose PayPal Payments Pro.
  2. Select the Country and State you would like this payment method to apply to.

Remember, if you have a PayPal Payments Pro account, it will automatically integrate PayPal Express when you add the Pro method. Also, if you're looking to only add PayPal Express, you can find the steps outlined here.

  1. Choose the Minimum and Maximum order amounts this payment method will apply for.
  2. Choose the Customer Group you would like the payment method to apply for.
  3. Click on the "Add New" button to install the module.

The payment method will now be added. Your next step is to configure its account settings.

  1. Look for the payment method in your list, then look to the far right of it and make sure its toggle is turned to the "On" position.
  2. Type in the email address associated with your Paypal account in the "PayPal Email" field.

Additional Information
At this time in the process, you can also mark the following checkboxes:

  • Authorize Only
    This checkbox will allow the payment to go through as an authorization for the amount of the order, but will not collect payment until you are ready. Click here for more information
  • Enable Billing Agreement
    Select this option if you have reference transactions enabled on your PayPal account which can be used with Shift4Shop's AutoShip add-on.
  • Allow guest checkout without PayPal account
    Marking this checkbox will make it so that your shopper can complete begin the checkout process on PayPal's side but without having to create or log into a PayPal account.
  • Add a PayPal Credit Payment Button
    Select this option to offer PayPal Credit to your shoppers as they purchase from your store. Click here for details.
  1. Once you are done with your settings, click "Save" at the top right to commit your changes.

Your store is now set up to take orders using PayPal Payments Pro.

PayPal Express Smart Payment Buttons

As mentioned already, PayPal Payments Pro automatically adds PayPal Express as an additional payment option. Beginning with version 8.2 of the Shift4Shop software, PayPal Express also includes integration with PayPal's Smart Payments button. This is a function that lets your store intelligently present the most relevant payment types to your shoppers - thereby making it easier for them to complete their purchase using methods like Pay with Venmo, PayPal Credit, and local alternative payment types.

Venmo users will need to have the Venmo app installed on their mobile device in order to see the Venmo option. Please click here for more information.

The new smart payment button feature also changes the way shoppers log into their PayPal Express accounts. In previous versions of PayPal Express, the customer would be redirected (from your store), to the PayPal Express login pages to complete their transactions.

In the current version of PayPal Express, the customer is no longer redirected back and forth. Instead, a popup window will appear for them that lets them log into their PayPal Account and complete the transaction. The advantage is that - visually - they are not being directed and redirected to and from your store but rather appear to never leave your store at all.

If your store's PayPal Express option is still redirecting customers in the old fashion, then you likely have customizations to your view cart and checkout templates that are not favoring the new functionality.

To correct this, please be sure that your store is using the most up to date version of the following HTML templates:

  • view_cart.html
  • checkout-singlepage.html
  • checkout-singlepage-v2.html
  • checkout-step1.html
  • checkout-step3.html
  • checkout-step3_multiple.html

For more information on how to update your template files to the latest version, please click here.

Help Desk Software by Kayako fusion