Target Audience

This article is for users of PayPal for WooCommerce who are running on one of the PayPal Classic Gateways.

If you are looking to set up the plugin for the first time, you can go directly to our PayPal Complete Payments Setup Guide.


PayPal has launched a brand new set of products and tools for integrating payments called PayPal Complete Payments.

They are no longer officially supporting the Classic gateways, so we need to get you migrated into this new system as quickly as we can.

Here’s how this benefits you!

  • Credit card fees reduced from 2.9% to 2.69%!
    • Apple/Google Pay also provided at this reduced rate!
  • Modern PayPal button stack.
  • Accept debit / credit cards directly from your site!
  • No more monthly fee for PayPal Pro features!
  • Easier access to the Vault / Reference Transactions.
  • Access to upcoming features like PayPal Fastlane.
  • Multi-Account functionality.

Get Help Migrating

We want to make this as simple and seamless as possible for you. This guide will help if you are comfortable doing it on your own.

If you are not comfortable with this or if you have any questions or concerns, please submit a ticket and we’ll help you through it.

Pre-Migration Preparation

Before initiating the migration process, it’s essential to ensure a smooth transition.  Follow these steps to prepare:

  1. Make Backups: Safeguard your data by creating backups of your WooCommerce store, including the database and files.
  2. Update Plugins/Themes: Ensure that all plugins and themes, including your WooCommerce installation, are up to date. Compatibility with the latest versions is crucial for a seamless migration.
  3. Review Compatibility: Check the compatibility of any subscriptions plugins, funnel plugins, autoship plugins, and other token payment integrations you have implemented. Verify that they are compatible with the PayPal Commerce gateway.
  4. Sandbox Testing: It is recommended that you create a staging copy of your site and configure it for use with the PayPal sandbox to ensure all payments are working properly on your specific site after migrating.  This is especially important if you have existing Subscription profiles or token payments of any kind.

By completing these pre-migration tasks, you’ll be well-prepared for a successful transition to the PayPal Complete Payments.

Potential Limitations

If you are working with our PayPal Multi-Account for WooCommerce plugin you will need to wait until further notice.  These features are not yet supported in our PayPal Complete Payments integration, but they are coming soon!

Step-by-Step Migration Procedure

1. Find the Update Notice in the WordPress Admin Panel

  • Make sure you are running the latest version of the PayPal for WooCommerce plugin.
  • Look for the following update notice and click the Upgrade Now button to move to our migration wizard.
PayPal Commerce Platform Update Notice
  • Alternatively, you can go to WordPress Settings -> PayPal Commerce from the admin menu.
PayPal Commerce Platform Settings Menu

2. Review the Upgrade Details and Click the Update Button

  • Review the details of your current PayPal integration.
  • Review the details of what you will get when you update to PayPal Commerce.
  • When you are ready, click the Update to PayPal Complete Payments button to begin the process.
  • NOTE: You can submit a help desk ticket or schedule a live session with Drew to help you with this migration if you have any questions or concerns.
PayPal Commerce Platform Migration Wizard

3. Connect Your PayPal Account

  1. Enter your PayPal account email and country.
  2. Log in to your existing PayPal account.
  3. Review the bulleted details of the app connection and click Agree and Connect.
  4. Click the “Go back to…” button to return to the migration wizard screen.


PayPal Commerce Platform Migration Wizard Step 1


PayPal Commerce Platform Migration Wizard Step 4


PayPal Commerce Platform Migration Wizard Step 2


PayPal Commerce Platform Migration Wizard Step 3

4. Success!

PayPal Commerce Platform Migration Wizard Step 5

Testing and Validation

After completing the migration, it is crucial to thoroughly test and validate the functionality of your PayPal Commerce integration.

  1. Order Checkout: Run a test order to ensure new orders are processing as expected on the new PayPal Commerce gateway.
  2. Subscription Payments: Process sample subscription payments to ensure they are functioning correctly with the PayPal Commerce gateway.
  3. Funnel Plugin Upsells: Test any upsell functionality within your funnel plugins to verify that they are seamlessly integrated with the PayPal Commerce gateway.

By conducting these tests, you can ensure that all aspects of your token payments, including subscriptions and upsells are functioning properly within the PayPal Commerce gateway.

Something Not Working Correctly?

Please submit a ticket and we will work with you to get this issue resolved right away!

Frequently Asked Questions

Can I get live help with this migration?

Absolutely!  If you have any questions or concerns and would like to work with Drew directly for this migration, please schedule a session and he will be happy to help!

Will I need to be approved for Reference Transactions in order to use Subscriptions?

Yes…but it’s a lot easier than it was in PayPal Classic!

After connecting your PayPal account to the plugin, go into the gateway settings and look for the Subscriptions / Tokenization option.  

Here, you’ll need to enable that specific feature by approving it with your PayPal account.  

This triggers the application for reference transactions, but in most cases you will be immediately approved.

Once this shows “connected” in the settings you’re ready to use Woo Subscriptions or any other token payment functionality.

What if I am using Woo Subscriptions? What happens to my Active / On Hold profiles?

If you are using WooCommerce Subscriptions and you have active / on-hold profiles, the migration wizard will update them so that they will be processed using the PayPal Commerce gateway from that point forward.

This includes the following gateways:

Will my funnel plugin(s) and upsell functionality continue to work?

PayPal Commerce fully supports upsells.  You just need to make sure you have the Tokenization feature enabled in the PayPal Commerce gateway settings.

Will I still need PayPal Payments Pro?

If you are currenly using PayPal Pro (ie. DoDirectPayment or PayFlow), this will no longer be necessary.

PayPal Commerce comes with what is called “Advanced Credit Cards” and this gives you the same functionality that PayPal Pro gives you in the Classic system.

After you migrate you will be able to cancel your Payments Pro subscription, so you won’t have to make that monthly payment anymore, and you won’t lose any functionality.

Need More Help?

If you have any questions or concerns feel free to submit a ticket to our help desk.  Our support team will be happy to help!