How to Set Up PayPal on Shopify: A Step-by-Step Guide

Introduction

Setting up PayPal is one of the first and most critical steps for any Shopify merchant looking to accept international payments. Because PayPal is a default payment provider for the platform, Shopify automatically creates a preliminary account for you using the email address you used to sign up for your store. However, simply having this account is not enough to run a professional business; you must complete the integration to ensure you can capture funds, issue refunds, and provide a clear experience for your customers.

While the basic connection is straightforward, many merchants eventually find that a one-size-fits-all payment layout does not work for every market. We built HidePay on the Shopify App Store to give you more control over these native options, allowing you to sort, rename, or hide payment methods based on specific customer criteria once your initial setup is complete. For a deeper introduction to the app and its goals, see the Nextools post introducing HidePay.

By the end of this article, you will understand how to verify your account, configure your capture settings, and manage the PayPal Express Checkout experience to maximize conversions.

Understanding the Default Shopify PayPal Integration

When you open a Shopify store, the platform assumes you want to offer PayPal. It pre-configures "PayPal Express Checkout" using your store's primary contact email. If you already have a PayPal account tied to that email, you might even see orders coming in immediately.

However, these funds often remain "pending" until you formally link and verify a Business account. Using a personal PayPal account is technically possible but highly discouraged for e-commerce. A Business account is required to access essential features like "Reference Transactions" (for subscriptions) and the ability to process refunds directly from the Shopify admin.

If you decide that PayPal isn't the right fit for your business—perhaps due to high transaction fees in your specific region or high chargeback rates—you should deactivate it manually. Leaving an unconfigured PayPal option at checkout can lead to failed transactions and frustrated customers who try to use a method that isn't fully active.

Step-by-Step: Connecting Your PayPal Account

The connection process involves granting Shopify permission to communicate with your PayPal account. This ensures that when a customer pays, the data is accurately reflected in your Shopify orders.

Connecting on a Desktop

1. Log in to your Shopify admin and navigate to Settings, then click on Payments.
2. In the Additional payment methods or PayPal section, you will see a button labeled Setup incomplete or Activate PayPal Express Checkout.
3. Click Complete setup or Activate.
4. You will be redirected to the PayPal login page. Enter the email address associated with your PayPal Business account.
5. Enter your password and log in.
6. A permissions page will appear, asking you to grant Shopify access to your account data and payment processing. Click Agree and Connect.
7. Once the process is finished, click the button to Go back to Shopify.

Connecting on Mobile

1. Open the Shopify app and tap the Store icon or the three dots in the bottom right.
2. Go to Settings and then Payments.
3. Locate the PayPal section and tap Complete setup.
4. Follow the prompts to log in to your PayPal account and authorize the connection.
5. Return to the app once the confirmation screen appears.

Configuring Payment Authorization

A common point of confusion for new merchants is the difference between "Manual" and "Automatic" payment capture. This setting determines when you actually take the money from the customer's account.

Automatic Capture

This is the standard for most retail businesses. When a customer completes their order, the funds are immediately captured and moved to your PayPal balance. This is the most efficient choice if you ship items quickly and have reliable inventory.

Manual Capture

In this scenario, PayPal "authorizes" the payment, essentially putting a hold on the funds. You then have a specific window (usually 3 to 7 days, depending on your PayPal agreement) to "capture" the payment manually within the Shopify order screen. This is often used by:

• B2B Merchants: When you need to verify shipping costs or stock before finalizing a large order.
• Custom Manufacturers: If you need to review an order for technical feasibility before taking the customer's money.
• High-Risk Stores: To allow time for a fraud review before the transaction is finalized.

To adjust this, go to Settings > Payments and look for the Payment Authorization section. Remember that if you use manual capture and forget to claim the funds before the authorization period expires, the order will remain unpaid and the hold on the customer's funds will be released.

The Importance of the Business Account

If you are using a personal PayPal account, your store name may not appear correctly on the customer's bank statement. Instead, they might see your personal name, which can lead to "unrecognized transaction" chargebacks.

Upgrading to a Business account is free and allows you to:

• Set a Doing Business As (DBA) name: This ensures the customer sees your store name on their credit card or PayPal statement.
• Add multiple users: You can grant your staff or accountants limited access to your PayPal dashboard without giving them your primary password.
• Access Seller Protection: This is vital for protecting your revenue against fraudulent "item not received" or "unauthorized payment" claims.

Managing the PayPal Express Checkout Button

PayPal Express is designed to speed up the checkout process by allowing customers to skip the shipping and billing address forms on Shopify. While this can increase conversion rates, it also introduces specific behaviors you should be aware of.

Address Handling Logic

When a customer uses the Express button, Shopify sends the customer’s shipping address to PayPal. PayPal then uses that address to calculate taxes and shipping. A common issue occurs when a customer wants to use a different billing address than their shipping address. While they can change this within the PayPal pop-up, Shopify only receives one primary address from the initial "express" handoff.

If you offer "In-store Pickup," the Express button can sometimes cause issues because the customer's saved PayPal address might override the pickup location logic. In these cases, many merchants choose to use the app to hide express checkout buttons specifically when a pickup method is selected; see the guide for how to hide payment methods by the selected delivery method type. For conditional shipping rules that work together with conditional payments, many merchants pair HidePay with HideShip on the Shopify App Store.

Language and Localization

Shopify attempts to tell PayPal which language to display based on the customer’s IP address and store settings. If your store is set to German, Shopify will signal PayPal to show the login screen in German. If the customer's data is unavailable, PayPal defaults to the address you have listed in your Shopify General Settings.

Optimizing the Checkout Experience

Once the technical setup is complete, you need to consider how PayPal fits into your broader payment strategy. Showing too many payment options can lead to "decision paralysis," where a customer becomes overwhelmed and abandons their cart. Conversely, hiding PayPal in a region where it is the primary payment method can destroy your conversion rate.

This is where the app provides significant value. Using our tool, you can create a payment customization in HidePay to manage exactly when and how PayPal appears.

Sorting for Preferred Methods

If you prefer a different payment gateway (like Shopify Payments) because the fees are lower, you can use our tool to sort PayPal further down the list. By placing your preferred, lower-fee method at the top, you guide the customer toward the option that is best for your bottom line while still keeping PayPal available for those who insist on using it. See the Help Doc for tips on how to sort payment methods with identical names.

Hiding Based on Product Type

Some merchants sell items that are prohibited by PayPal’s Acceptable Use Policy or carry a higher risk of disputes. If you have a specific collection of products that often lead to PayPal disputes, you can create a rule in our app to hide the PayPal option only when those specific items are in the cart. Follow the step-by-step on how to hide a collection of products in the cart with HidePay.

Geographical Filtering

In some countries, PayPal is less popular or carries higher cross-border fees. You might want to offer PayPal to US and UK customers but hide it for customers in a specific country where local digital wallets are preferred. Our app allows you to set geography-based rules so the checkout always feels local and relevant.

Testing Your PayPal Integration

Never assume the integration is working perfectly just because the "Active" status is shown. You should always perform a test transaction.

How to Test Safely

1. Create a hidden product: Set up a test product priced at $1.00.
2. Use a different account: You cannot buy from your own store using the same PayPal account that is receiving the money. You must use a separate personal PayPal account or ask a friend to help.
3. Check the order flow: Complete the purchase and ensure that the order appears in your Shopify admin as "Paid."
4. Test the refund: Once the payment is confirmed, go into the Shopify order and issue a full refund. Verify that the money is returned to the test account and that the status updates correctly in both Shopify and PayPal.

If you are on a Shopify trial plan, you will need to select a paid plan before you can process a real transaction. Your credit card will not be charged until the trial ends, but the checkout must be "active" to communicate with PayPal's servers.

Troubleshooting Common Setup Issues

Even with a correct setup, you may encounter hurdles. Most of these are related to account verification rather than the Shopify-PayPal connection itself.

Pending Payments

If an order shows as "Pending" in Shopify and you see a message in PayPal saying the funds are not yet available, it usually means your email address has not been verified. Check your inbox for a confirmation email from PayPal. Once verified, it can take up to 48 hours for the funds to move from pending to available.

"Setup Incomplete" Error

If Shopify continues to show "Setup Incomplete" after you have gone through the login flow, it usually means the permissions were not fully granted. The best fix is to click Deactivate in the Shopify Payments settings and then start the connection process again from scratch.

Missing Express Buttons

If the PayPal button is missing from your product pages or the first stage of checkout, check your theme settings. Some themes require you to manually enable "Dynamic Checkout Buttons." Additionally, if you have active rules in our app that are configured to hide PayPal under certain conditions, ensure those conditions aren't accidentally blocking the button for all users. For guidance on hiding express checkout buttons with HidePay, see the Help Doc on how to hide the Express Checkout with HidePay.

Advanced Control with Shopify Functions

Our app is built on native Shopify Functions. This is a significant technical distinction because it means our rules run directly within Shopify’s infrastructure. Unlike older apps that relied on "Script Editor" or "Theme Liquid" edits, our tool does not slow down your checkout or break when Shopify updates its code. For background on why Shopify Functions are replacing scripts, read the Nextools article on why Shopify Functions are the future.

Using these functions, we provide a robust way to rename the "PayPal" label at checkout. For detailed instructions, see the guide to Hide, Sort or Rename Payment Methods on your Shopify Store with HidePay. For example, if you want to clarify that PayPal also allows credit card payments without an account, you can rename the method to "PayPal or Credit Card." This small change in phrasing can significantly reduce friction for customers who do not have a PayPal account but want to use the secure gateway.

Action Summary for Merchants

To ensure your PayPal setup is optimized for growth, follow these steps:

• Upgrade to Business: Ensure your PayPal account is a Business account and the email is verified.
• Set Capture Logic: Choose between Automatic and Manual capture based on your fulfillment workflow.
• Conduct a Test: Complete a real $1 transaction to verify the end-to-end flow.
• Refine the UI: Use HidePay to sort PayPal in a way that prioritizes your most profitable gateways or hide it where it’s not appropriate.
• Monitor Disputes: Keep an eye on your PayPal resolution center to ensure your "Doing Business As" name is clear to customers.

Conclusion

Setting up PayPal on Shopify is the foundation of a global payment strategy, but the "default" settings are rarely the "optimal" settings. By connecting your Business account correctly and configuring your authorization settings, you ensure that your cash flow remains steady and your customers remain informed.

Once the basics are in place, the real growth happens when you begin to treat your checkout as a strategic asset. By using rules to sort, rename, and hide payment methods, you create a tailored experience that reduces friction and protects your margins. Effective payment management isn't just about accepting money; it's about providing the right options to the right people at the right time.

Take the next step in optimizing your store by install HidePay today to gain full control over your checkout.

FAQ

Why does my Shopify admin say "Setup incomplete" for PayPal?

This usually occurs when the email address used for your Shopify store hasn't been verified with a PayPal Business account. Even if you have connected the accounts, PayPal requires email verification to ensure security and to enable features like manual payment capture and refunds.

Can I hide the PayPal button for certain countries?

Yes, but you cannot do this using Shopify's default settings. You need an app like HidePay to create geography-based rules. This allows you to keep PayPal active for regions where it converts well while hiding it in countries where you prefer customers use local payment providers.

What is the difference between PayPal and PayPal Express?

On Shopify, these are essentially the same integration. "Express" refers to the accelerated checkout buttons that appear on product pages or at the top of the checkout. These buttons allow customers to use their saved PayPal information to bypass entering their shipping address on your site.

Do I need a credit card to set up PayPal on Shopify?

You do not need a credit card to link the accounts, but PayPal will require you to link a bank account or a debit/credit card to your PayPal Business profile to verify your identity and allow you to withdraw funds. Shopify also requires you to be on a paid plan to accept live payments.