Back to Platform Selection

Adobe Commerce

PayPal Upgrade Guide

This document outlines the recommended path for merchants using Adobe Commerce or Magento Open Source to transition to the latest PayPal integration. The steps vary depending on your site version and the specific capabilities you require. No matter your setup, there is a streamlined migration path designed to minimize friction and ensure a smooth upgrade experience.

Requirements & Installation

Why Upgrade

  • Each merchant runs a specific version of Adobe Commerce or Magento Open Source, which determines the underlying cart framework.
  • Staying on the latest version of Adobe Commerce or Magento Open Source ensures your site is protected with the most recent security patches, optimized for peak performance, and fully compatible with the newest PayPal capabilities.
  • We recommend upgrading your Commerce version and PayPal integration together to deliver the most seamless, secure, and future-ready experience for your business and your customers.

Prerequisites

  • To check your version, log in to your Adobe Commerce or Magento Open Source Admin panel. Scroll to the bottom-right corner of the page, where you’ll see a version number displayed in a three-part format (for example, 2.4.8). Versions range from 1.x through 2.4.8+. See the example below.

image

Upgrade Paths Based on Version

There are four recommended migration paths depending on your Adobe Commerce or Magento Open Source version and business needs:


*Note, to add Apple Pay using any of the above upgrade options, verify any domain names in your live environment that will show an Apple Pay button. Apple Pay transactions only work on a domain and site registered to you.


PayPal Support

For any concerns or technical questions regarding your upgrade, you may reach out to upgrade@paypal.com for support.