1. Documentation

PayPal Payments Upgrade Guide

This document guides you on the process of moving to the recommended PayPal Payments 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 WooCommerce.com 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. When performing a fresh install of PayPal Payments, and if PayPal Checkout is enabled and configured, PayPal Payments will attempt to carry all of your settings over to the new plugin. You’d still have to connect your PayPal account, as described above. 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. Starting with version 1.5.0, PayPal Payments will take over subscription renewals from PayPal Checkout when the latter is not active. This allows you to completely disable or remove the PayPal Checkout extension, while subscription renewals continue to be processed correctly.

We recommend disabling the PayPal Standard and PayPal Checkout gateways (under WooCommerce > Payments) to prevent customers from purchasing new subscriptions using those gateways.

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. As long as you have properly configured the extension for use with WooCommerce Subscriptions, you can switch those subscriptions over to PayPal Payments following the process outlined in Change Payment Methods.

Please keep in mind that there’s no need to do this for customers paying you via PayPal Standard or PayPal Checkout, as those subscriptions will continue to be processed by a compatibility layer built into PayPal Payments (starting with version 1.5.0).

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.

Please be aware that subscription renewals for subscriptions initially purchased with PayPal Checkout will continue to be processed by PayPal Payments once the PayPal Checkout extension is disabled.

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 WordPress.org.

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.


The most customizable eCommerce platform for building your online business.

  • 30 day money back guarantee
  • Support teams across the world
  • Safe & Secure online payment