Introduction
Linking PayPal to your Shopify store is a foundational step in building a trustworthy checkout experience. Because PayPal is one of the most recognized payment providers globally, offering it can significantly reduce friction for customers who prefer not to enter credit card details directly. When you use tools like HidePay on the Shopify App Store to manage how these options appear, you gain even more control over your conversion rates and processing fees.
This guide provides a direct walkthrough of the connection process, explains the difference between standard integration and the PayPal Wallet, and outlines how to optimize PayPal's visibility at checkout. Whether you are setting up a new store or migrating an existing account, the following steps ensure your payment flow is functional and secure. Connecting your account correctly allows you to capture payments, issue refunds, and manage disputes directly from your Shopify admin. For a deeper look at the problem HidePay solves, see the Nextools post "Introducing HidePay for Shopify." (link below)
The Automatic Setup Process
Shopify streamlines the integration by automatically creating a PayPal Express Checkout account the moment you open your store. This account is tied to the email address you used to sign up for Shopify. While this allows you to begin receiving payments immediately, the integration is technically "incomplete" until you finalize the connection with a PayPal business account.
If you already have a PayPal account using that same email address, you are ahead of the curve. However, if your business PayPal uses a different email, or if you only have a personal account, you must perform a manual linking process to ensure funds are accessible and administrative functions—like refunds—work as intended.
Steps to Link Your PayPal Account
To move beyond the automatic setup and fully authorize the connection, follow these steps within your Shopify admin. This process grants Shopify the necessary permissions to communicate with PayPal's API.
Connecting on Desktop
- Log in to your Shopify admin and navigate to Settings, then select Payments.
- Locate the Additional payment methods section. You should see a PayPal block.
- If the status says "Setup incomplete," click Complete setup or Activate PayPal Express Checkout.
- You will be redirected to a PayPal login page. Enter the email address associated with your PayPal business account.
- Enter your password and click Log In.
- Review the permissions page, which asks you to grant Shopify access to perform specific actions like processing refunds and looking up transaction details. Click Agree and Connect.
- Once the "You’ve successfully authorized Shopify" message appears, click Go back to Shopify.
Connecting via the Shopify Mobile App
- Open the Shopify app and tap the three-dot menu or your profile icon to access Settings.
- Tap Payments.
- Under the PayPal section, tap Complete setup.
- Follow the prompts to log into your PayPal business account and grant permissions.
- Tap Back to Shopify once the authorization is confirmed.
After completing these steps, your PayPal status should update to "Active." If you are using a new PayPal account, ensure you have verified your email address within the PayPal dashboard itself. Payments sent to an unverified email will remain in a "pending" state and may be reversed if the email is not confirmed within 30 days.
Hide, sort, and rename Shopify payment methods using powerful conditions. Customize your checkout and control payment options with HidePay.
Understanding PayPal Wallet vs. Express Checkout
For merchants based in the United States using Shopify Payments, the integration may look slightly different. Shopify recently introduced the PayPal Wallet integration, which weaves PayPal directly into the Shopify Payments ecosystem.
PayPal Wallet (US Merchants Only)
When you use PayPal Wallet, your PayPal transactions are managed alongside your credit card transactions. Payouts are bundled together and sent to your bank account on the same schedule as your Shopify Payments payouts. This eliminates the need to manage a separate balance within PayPal for your Shopify sales.
Key details of this integration include:
- Centralized Management: Disputes and refunds are handled directly in the Shopify admin rather than the PayPal Resolution Center.
- Consolidated Reporting: PayPal sales appear in your Shopify Payments financial reports.
- Automatic Activation: This is often enabled by default for new US-based stores using Shopify Payments.
PayPal Express Checkout
For merchants outside the US or those not using Shopify Payments, PayPal Express Checkout is the standard method. In this setup, your funds accumulate in your PayPal account balance. You are responsible for transferring those funds to your bank, and you must handle disputes within the PayPal Business Center. Even with this standard integration, we recommend using a professional business account to ensure you have access to features like guest checkout, which allows customers to pay with a card without creating a PayPal account.
For merchants who also want to control shipping options alongside payments, Nextools explains the value of combining payment and shipping tools in "Introducing Nextools’ HideSuite: the bundle for smart Shopify merchants."
Essential Post-Link Configurations
Linking the account is only the first half of the process. To ensure the customer experience is consistent, you need to configure how PayPal behaves during the checkout transition.
Payment Authorization Settings
In your Shopify Payment settings, you can choose between two authorization methods:
- Automatically capture payment for orders: This is the most common choice. The customer is charged immediately upon checkout.
- Manually capture payment for orders: This authorizes the funds but does not "charge" the customer until you manually fulfill the order or click "Capture" in the admin. Use this if you have long lead times or need to verify inventory before taking payment.
Address Handling
One technical nuance of the PayPal integration is how it handles addresses. Shopify typically sends the shipping address to PayPal. PayPal then uses this to populate the billing address fields. If a customer is using a "Pickup in Store" option, the billing address may occasionally be missing or require manual entry within the PayPal window. You should inform your customer service team of this behavior to help troubleshoot rare checkout queries.
Language and Localization
Shopify attempts to detect the customer's location via their IP address and informs PayPal which language to display. If the customer's location cannot be determined, PayPal defaults to the address listed in your General Settings under Business Details.
Testing Your PayPal Integration
Before going live, it is vital to confirm that the link is working correctly. You cannot test PayPal using the "Test Mode" toggle found in Shopify Payments; you must perform a real transaction.
To test properly:
- Create a temporary product in your store with a low price (e.g., $1.00).
- Open your store in an incognito or private browser window.
- Add the product to your cart and proceed to checkout.
- Select PayPal as the payment method.
- Note: You cannot pay yourself. You must use a different PayPal account (personal or a second business account) than the one linked to your store to complete the purchase.
- Complete the payment. If successful, check your Shopify admin to ensure the order is marked as "Paid" and check your PayPal dashboard to see the transaction.
- Refund the transaction immediately to recover your test funds (minus any small non-refundable processing fees from PayPal).
Optimizing the PayPal Experience at Checkout
Once your link is active, you may find that you don't want PayPal to be the primary option for every customer or every order. While PayPal is excellent for conversion, it can also carry higher processing fees or different dispute rules than other gateways.
Many merchants pair payment controls with shipping controls to reduce unexpected costs; for shipping-specific rules, merchants often add HideShip on the Shopify App Store to the stack.
Many high-volume merchants use our app to refine this experience. By creating specific rules, you can manage how and when PayPal appears. See our support guide on How to create a payment customization for step‑by‑step instructions on building rules inside HidePay.
Sorting Payment Methods
By default, Shopify may place PayPal at the very top of the list or as an "Accelerated Checkout" button. If you prefer customers to use a different gateway (perhaps one with lower fees), you can use the app to reorder the list. Moving PayPal below your primary credit card processor can nudge customers toward your preferred method while still keeping PayPal available for those who truly need it.
To learn how to reorder and rename options, follow the guide: Sort and Rename payment methods in the Checkout.
Hiding PayPal Based on Conditions
There are scenarios where hiding PayPal is a strategic business move. For example, if you sell high-ticket items and find that PayPal disputes are more difficult to win than credit card chargebacks, you might create a rule to hide PayPal for orders over a certain dollar amount.
Other common rules include:
- Geography: Hiding PayPal in countries where it isn't a popular choice to keep the checkout clean.
- Customer Tags: Offering PayPal only to retail customers while hiding it for B2B/Wholesale customers who must pay via bank transfer.
- Product Type: Restricting PayPal for specific items that may violate PayPal’s Acceptable Use Policy, protecting your account from being flagged.
To set up region-based rules, see the guide on How to easily organize payment methods by country or by Shopify Market.
Using the tool to implement these rules ensures that your checkout remains lean and focused on the methods most likely to result in a successful, low-cost transaction.
Troubleshooting Common Linking Issues
If you encounter issues while linking or using PayPal, check these three common points of failure:
- Pending Payments: If an order shows as "Pending" in Shopify and you see the money hasn't hit your PayPal account, it is almost always due to an unverified email address. Log into PayPal and ensure all email addresses on the account are confirmed.
- Permissions Errors: If you cannot issue a refund from within Shopify, the API permissions may have lapsed. Deactivate PayPal in your Shopify settings and then go through the "Complete Setup" process again to refresh the connection.
- Only One Address Sent: If customers complain they cannot change their billing address, remember that Shopify primarily sends the shipping address to PayPal Express. The customer must click "Change" within the PayPal popup to modify this.
If the problem appears to be a mismatch between a payment method name or missing entry in your rules, our help article How to Retrieve the Correct Payment Method in HidePay explains how to use the app logs to find the exact method identifier.
Conclusion
Linking PayPal to your Shopify store is a straightforward process that provides immediate benefits in terms of customer trust and checkout speed. By moving from the automatic setup to a fully authorized business connection, you unlock the ability to manage your finances efficiently from a single dashboard.
To take your checkout a step further:
- Confirm your PayPal email is verified.
- Choose between automatic and manual capture based on your fulfillment logic.
- Perform a test transaction with a separate account.
- Use a tool like our app to sort or hide payment methods based on your business needs.
If you are looking for total control over your checkout flow, install HidePay to start organizing your payment methods today.
FAQ
Can I link a personal PayPal account to my Shopify store?
While you can technically link a personal account, we strongly recommend using a PayPal Business account. Business accounts allow you to accept credit card payments from customers who do not have a PayPal account and provide more robust reporting and integration features necessary for running a professional store.
Why does my checkout say "Setup incomplete" even though I've used PayPal before?
This usually happens if the email address used for your Shopify store doesn't match your existing PayPal account or if you haven't granted the necessary API permissions. To fix this, click "Complete setup" in your Shopify payment settings and log into the correct PayPal business account to authorize the connection.
How do I change the PayPal email address linked to my Shopify store?
To change the email, go to Settings > Payments in your Shopify admin. Click on the PayPal section and select "Deactivate." Once deactivated, click "Activate" again and log in with the new email address you wish to use. This will reset the connection with the updated credentials.
Does linking PayPal to Shopify cost anything?
There is no fee from Shopify to link your PayPal account. However, PayPal charges its own transaction fees on every sale made through their gateway. These fees vary by region and sales volume; check PayPal’s rates in your PayPal account.
Further reading and resources:
- Introducing HidePay for Shopify (Nextools blog)
- Introducing Nextools’ HideSuite (Nextools blog)
- HidePay help documentation and tutorials available in the app documentation.