How to Add PayPal to Shopify: Express Checkout or Wallet

Open Settings › Payments in a Shopify store based outside the US, France and India, and, Shopify says, PayPal is already in the Additional payment methods section: Shopify generated a PayPal Express Checkout account on the email you sign in with when you created the store. In the US and France, a store on Shopify Payments finds no PayPal line there at all, because PayPal arrives as PayPal Wallet inside Shopify Payments.

So adding PayPal means finishing a connection Shopify already started, or checking the Wallet route Shopify Payments set up for you. Then a real test order proves that buyers can pay and that you can refund them. This guide follows that order and ends with the PayPal errors Shopify documents and their fixes.

Which PayPal Route Does Your Store Use?

Shopify runs PayPal in two configurations, and which one you have depends on where your store is based and whether Shopify Payments is active. Find your row before you click anything. Express rows continue in the next two sections; if your row is PayPal Wallet, go straight to PayPal Wallet in the US and France.

The US-and-France row with Shopify Payments is where the usual setup steps stop working, because those steps start from Additional payment methods, and for those stores that list carries no PayPal line. Shopify's PayPal page states the boundary as a caution:

The setup guide narrows that to merchants who use Shopify Payments: for them, Express Checkout isn't available as a separate payment gateway. The US PayPal Wallet page adds that PayPal can then only be integrated through the Shopify Payments Wallet.

A US store whose sales tax Shopify manages is the hard stop. Shopify's requirements for that mode say payments must be processed through Shopify Payments, and that manual payment methods, custom payment methods and PayPal can't be used. As of November 1, 2026 the mode is in early access, available only to certain stores that opened after October 27, 2026.

What if you're in the US without Shopify Payments?

The question is whether a US store that does not use Shopify Payments can still run PayPal Express Checkout. Shopify's pages, read on November 1, 2026, point two ways:

• The caution on Shopify's PayPal page says Express Checkout isn't available to merchants in France or the United States, with no condition attached.
• The setup guide's tip scopes the same point to US and French merchants who use Shopify Payments.
• The supported-integrations page describes a US merchant who has PayPal Express Checkout activated, with Venmo then showing to eligible customers. The US Wallet page offers Venmo to stores that don't want Shopify Payments by adding PayPal Express as a third-party gateway.

Let your admin settle it. Open Settings › Payments: if PayPal sits under Additional payment methods, the Express Checkout steps below apply to your store. The Venmo version of this route, and Shopify's third-party fee on it, is covered in whether Shopify accepts Venmo without Shopify Payments.

Which PayPal name is which?

The names matter when you read Shopify's help pages, because each one points at a different setup. As of November 1, 2026, Shopify's list of supported PayPal integrations has four entries; a fifth name, PayPal Standard, is discontinued:

If your store runs Payflow Pro, PayPal Payments Pro (US) or Website Payments Pro (UK or Canada), Shopify's update page says you must move to the Braintree payments app. Express Checkout that ran inside one of those gateways is then activated again under Additional payment methods.

Does PayPal cost extra on Shopify?

This guide leaves fees to the gateway comparison and keeps the one point that changes your setup: Shopify's integrations page says that if you elect Shopify Payments as your primary payment provider, PayPal transactions are exempt from third-party transaction fees. When else that surcharge is waived, and what it costs when it isn't, is in when Shopify's third-party surcharge is waived.

What Your PayPal Account Needs Before You Connect

Shopify lets the Express account take money before you finish: its integrations page says you can start accepting payments immediately without requiring a PayPal account, and complete registration later. The four conditions below decide whether that money reaches you and whether you can refund it.

Shopify's common-issues page sends a personal-account holder to PayPal's own help center for the switch, and PayPal's upgrade instructions start from Settings and the Account Options section.

For the email, Shopify's setup guide tells you where to look: go to Settings › General and find your Store email in the Store contact details section. The guide calls it your PayPal account email, so compare it with the email on your PayPal account before you start.

In Shopify adminOpen in your store

1. Settings
2. General
3. Store contact details

Zoom

Your PayPal account uses a different email

Shopify's setup guide gives exactly two routes when your PayPal business account sits on another address: add your store email to that existing account, or sign up for a new PayPal business account using the same email address you use to sign into your store.

On PayPal's side, keep one rule in mind for the first route: PayPal's help says you can't edit or delete your primary email address, so your store email joins the account as an added address.

If the address is new to your PayPal account, verify it: PayPal sends a confirmation email automatically when you add an address.

How to Connect PayPal Express Checkout, Step by Step

Only the store owner can do this: for security, Shopify lets only the owner edit the store's PayPal Express information. Shopify's setup guide splits the job into a Shopify part and a PayPal part.

In your Shopify admin:

1. Go to Settings › Payments.
2. In the Additional payment methods section (our development store headed it More ways to pay on November 2, 2026), click Setup incomplete next to PayPal.
3. Click Complete setup.

In Shopify adminOpen in your store

1. Settings
2. Payments

Zoom

Then, on PayPal's pages:

4. Enter the email address for your PayPal account and click Next, then your password and Next.
5. On the Tell us about your business page, enter your business details.
6. Review and select the policy and permissions statements, then click Agree and Create Account.
7. On the Describe your business page, select your business type, enter your details and click Next; then on the Tell us more about you page enter your details and click Submit.
8. On the confirmation page, click Go back to Shopify.
9. Make a test transaction to confirm that everything is set up properly.

On a phone, the same path starts in the Shopify app: Settings › Store settings › Payments.

If you decide not to offer PayPal at all, deactivate it from the same Payments settings. Shopify says this avoids exposing your email address publicly, and that your account details are saved so you can reactivate PayPal Express Checkout at any time. The full off-switch, including what changes in the US and France, is in how to remove PayPal from Shopify.

Why finish setup if payments already arrive?

Skipping the PayPal part is tempting when orders already come in: if a PayPal account already exists on the email you use for your store, Shopify says you can start receiving payments immediately. The setup guide then adds the catch:

Shopify also lists automated order cancellations among Express Checkout's features: when an order is canceled on Shopify, the refund process is automated, so there is no manual refund to make through your PayPal account.

PayPal Wallet in the US and France: What to Check

In the US and France, a store that uses Shopify Payments gets PayPal as part of Shopify Payments rather than as a separate provider. When you create your store and set up Shopify Payments for either country, you automatically receive a PayPal Wallet account, and the French Wallet page says PayPal is then not available in the Additional payment methods section of your admin. Three checks confirm it is working:

1. Shopify Payments is set up for your US or French store; the Wallet account comes with it.
2. Your store uses the most upgraded version of Shopify Checkout. Shopify sets this as a condition for using PayPal Wallet in both countries.
3. PayPal shows up in your Shopify admin. In the US, Wallet transactions display on the transactions page and their payouts in the Payouts section; in France, all PayPal settings and transactions, including disputes and refunds, are managed in the Shopify admin.

A US store that took PayPal Express Checkout orders before Wallet was activated still needs that Express account for refunds and disputes on those older orders. How long to keep a PayPal Express balance after switching to Wallet gives Shopify's window.

In the US, Shopify says you manage Wallet transactions, payouts and disputes through the Shopify Payments section of the admin. Who handles a PayPal dispute on a Shopify order covers who decides the case and how long you have to answer.

How to Test PayPal Before Customers Use It

For Express Checkout, Shopify's test is a real purchase, not a simulator. Its testing instructions set the order:

1. Pick a paid plan. A store on a trial plan has to select a paid plan to activate its checkout and make a test transaction.
2. Create a test product and buy it from your store with a different PayPal account than the one designated to receive payments.
3. Cancel and refund the order straight away. Shopify's test-order guide allows processing an order with a real payment provider and then immediately canceling and refunding it. PayPal may still charge its fees on the test payment. A refund that fails here points back to the Complete setup step.

For PayPal Wallet, Shopify's test-mode page for Shopify Payments says test mode isn't available, and that Wallet doesn't display as a payment option at checkout while test mode is activated.

Some providers do have a switch: Braintree and PayPal Payflow Pro offer a test mode you activate from the Shopify admin. No Shopify help page we found describes a test mode or sandbox for PayPal Express Checkout itself; the search boundary is listed at the end of the errors section.

Do You Need a Separate PayPal Button?

On a Shopify store there is no separate PayPal button to install. The branded buttons on product pages and at checkout are Shopify's accelerated checkout buttons, and Shopify ties them to your payment settings:

PayPal Express Checkout brings its button with it: Shopify describes a one-click accelerated checkout button that lets customers log in to their PayPal accounts and pay without entering any address details.

At checkout, accelerated checkout buttons sit in an Express Checkout section at the beginning of the checkout and are ordered dynamically to show the fastest method for each customer. Some accelerated checkout methods can also use buttons on product pages.

In Shopify adminOpen in your store

1. Online Store
2. …
3. Edit theme
4. Products
5. Default product
6. Product information
7. Buy buttons
8. Show full pathHide

Zoom

PayPal Not Showing at Checkout? Check Two Gates

No Shopify help page we found collects the reasons for a missing PayPal button in one place, so the two gates below assemble them from the PayPal, setup, Wallet, tax, testing and checkout pages and our development store. Work through gate one before gate two: a buyer can't see a method your store never switched on.

Gate one: PayPal isn't active in your store

The last row is a trade-off rather than a fix: switching the tax mode is its own decision, weighed in whether to switch Shopify's managed US sales tax to Self-directed.

Gate two: PayPal is active, but a buyer doesn't see it

Once PayPal is on, the buyer's side takes over. On product pages, Shopify says the kind of accelerated checkout button a customer sees depends on factors that include their browser, their device and their personal payment history. A missing button on one phone is therefore not proof that PayPal is off; check another browser or device before you change settings.

Inside the PayPal window, Shopify steps back: Express Checkout operates as a third-party gateway, so Shopify doesn't control the payment options that display within the PayPal checkout experience, and you can't manage Venmo availability from your Shopify admin. Pay Later is a PayPal offer with its own reach, covered in whether Shopify supports PayPal Pay Later.

PayPal Errors After Setup and How to Fix Them

Shopify's PayPal common-issues page pairs each message with a cause. Find the text you see:

If you run two stores on one PayPal account, the InvoiceID error is predictable: Shopify says it typically occurs when the same PayPal account is linked to multiple Shopify stores. Change each store's order ID format with its own prefix or suffix before the second store takes orders.

In Shopify adminOpen in your store

1. Settings
2. General
3. Order ID format

Zoom

The refund error is the one that blocks money going back to a customer. Shopify's fix has two parts: log in to your PayPal account to grant Shopify the required access, then deactivate and reactivate PayPal in your payment provider settings to re-establish the connection. Orders received while the connection was down may need manual refunds in PayPal.

A suspension comes from PayPal's side: Shopify's page says an excessive number of requests in a short timeframe can potentially trigger a temporary suspension of your account for 24 hours, and the fix it names is PayPal support.

PayPal Setup Checklist

Step one applies to every store, and steps five and six to every store that can use PayPal. For Wallet, Shopify Payments test mode isn't available, and step five's second-PayPal-account wording comes from the Express Checkout page. If your route is PayPal Wallet, skip steps two to four, which belong to Express Checkout, and use step one to confirm Shopify Payments and the upgraded checkout.

If your store is in India, read Shopify's PayPal India page before step three. If your row is the US store whose sales tax Shopify manages, stop at step one: PayPal can't be used in that mode, and switching it is the separate decision linked in gate one.

The Bottom Line

The work is short once you know your route; the mistakes come from treating every store the same way.

Frequently Asked Questions