PayPal Payments Upgrade Guide

This document guides you on the process of moving to the recommended PayPal extension. This is a newer, free extension that has the same and more features than older extensions.

Requirements & Installation ↑ Back to top

To use WooCommerce PayPal Payments, you’ll need:

  • a PayPal business account
  • WordPress version 5.3 or newer (installed)
  • WooCommerce version 3.9 or newer (installed and activated)
  • PHP version 7.1 or newer.

To install the extension on your site, log in to your WordPress admin dashboard and follow these simple steps:

  1. Go to Plugins > Add New.
  2. Search for the “WooCommerce PayPal Payments” plugin.
  3. Click on “Install Now” and wait until the plugin is installed successfully.
  4. Click “Activate Now” on the success page to activate the plugin.

Alternatively, if you have a account, you can directly download and install the extension to one of your sites by clicking “Free Download” to start the checkout flow.

Connecting your PayPal account ↑ Back to top

Once the WooCommerce PayPal Payments plugin has been installed and activated, you’ll need to connect your site to your PayPal account. Do to this:

  1. Log in to your WordPress admin dashboard and go to WooCommerce > Settings.
  2. Click the Payments tab.
  3. Click Set Up (or Manage if the extension is already active) next to PayPal.
  4. Check the Sandbox box if connecting your sandbox PayPal account. Leave unchecked for Production.
  5. Click Connect to PayPal and follow the prompts to connect your existing PayPal account or create a new account.
  6. You may be asked to provide additional information about your business to PayPal. You may present this information during the onboarding flow. Ensure the box is checked next to Enable/Disable.
Connect to PayPal button.

FAQ ↑ Back to top

Do I need to connect my site with PayPal again? ↑ Back to top

Yes. To get access to the new features that PayPal Payments unlocks, you’ll have to connect your site again, even if you had already done this for any of the other PayPal gateways.

Will PayPal Payments honor my current PayPal Checkout configuration? ↑ Back to top

With few exceptions, PayPal Payments supports all the same configuration options that were available in PayPal Checkout, but it won’t automatically carry those settings over when upgrading. Instead, you need to manually configure the settings after installation. You can find more information on PayPal Payments configuration options here.

Do I need to do anything to enable support for WooCommerce Subscriptions? ↑ Back to top

To be able to use PayPal Payments for Subscriptions renewals, your account has to be approved for Reference Transactions. You’ll also have to enable vaulting on your account and on the plugin settings.

I’m using WooCommerce Subscriptions and have customers paying via PayPal Standard and/or PayPal Checkout. Will those renewals continue to work? ↑ Back to top

Yes. As long as the PayPal Checkout plugin remains installed and activated, subscriptions renewals will be processed as before.

We also recommend disabling the PayPal Standard and PayPal Checkout gateways (under WooCommerce > Payments) to prevent customers from purchasing new subscriptions using those gateways, while still allowing existing subscriptions to continue.

I’m using WooCommerce Subscriptions on my site and have customers paying me via other gateways (including PayPal Standard and PayPal Checkout). Can I switch those customers to PayPal Payments? ↑ Back to top

Yes. There’s no way to do this automatically at the moment, but if you wish to do it, it is recommended you have customers follow the process outlined in Change Payment Methods.

Can I disable PayPal Standard or the PayPal Checkout gateway after installing PayPal Payments? ↑ Back to top

Yes. In fact, we recommend you do so to prevent customers from making new purchases using PayPal Standard or PayPal Checkout.

To disable any of these gateways:

  1. Go to WooCommerce > Settings > Payments.
  2. Make sure the toggle next to PayPal Standard is in the off state.
  3. Make sure the toggle next to PayPal Checkout is in the off state.

Can I deactivate or delete the PayPal Checkout plugin after installing PayPal Payments? ↑ Back to top

Initially, we recommend you only disable the PayPal Checkout gateway on the WooCommerce settings page after installing PayPal Payments. Once you’ve made sure you no longer need PayPal Checkout on your site, it should be safe to remove its plugin files.

Before doing that, you should confirm that:

  • PayPal Payments is working correctly for you and your customers.
  • Orders on your site that were made via PayPal Checkout no longer need to be managed (refunded, canceled, etc.) or you’re willing to manually handle those cases.
  • If using WooCommerce Subscriptions, you’ve made sure all your customers currently paying via PayPal Checkout have switched their payment method to PayPal Payments.

I’ve completely uninstalled the PayPal Checkout plugin and I’m having trouble with PayPal Payments. Where can I find the PayPal Checkout plugin now? ↑ Back to top

You should be able to download a copy of the PayPal Checkout plugin directly from

To install on your site:

  1. Log in to your WordPress admin dashboard.
  2. Go to Plugins > Add New.
  3. Click Upload Plugin.

If you need assistance with PayPal Payments, get in touch with our support team.

Does PayPal Payments support 3D Secure? ↑ Back to top

Yes. PayPal Payments has built-in compliance with two-factor authentication provided by cards (3D Secure).

I am moving from PayPal Pro to Paypal Payments. Does PayPal Payments Support Cardinal Cruise API? ↑ Back to top

Yes. In PayPal Payments, the 3D Secure functionality uses PayPal Payments aggregated connection to Cardinal.

Where can I find more information on PayPal Payments? ↑ Back to top

Visit the WooCommerce PayPal page to get more information or read the documentation.

WooCommerce - the most customizable eCommerce platform for building your online business.

Back to the top