Introduction
Configuring PayPal correctly is a fundamental step for any Shopify store aiming to accept international payments. While Shopify automatically initiates a connection using your store’s signup email, a partial setup can lead to delayed funds or restricted account features. By finalizing this integration, you ensure that transactions are processed efficiently and that your business has the necessary permissions to handle refunds and manual payment captures.
We developed HidePay to help merchants take this process a step further by controlling exactly when and where payment options appear — get HidePay for your store. While the initial setup focuses on connectivity, the long-term success of your store depends on how you present these options to your customers. Managing your checkout layout is a key part of reducing friction and improving conversion rates.
This guide provides a detailed walkthrough of the PayPal configuration process for Shopify merchants. We will cover account types, permission settings, and the specific steps needed to move from a default placeholder to a fully functional business account. You will learn how to optimize your checkout flow to ensure that PayPal works effectively for your specific business model.
Understanding the Default PayPal Setup
When you open a Shopify store, the platform creates a PayPal Express Checkout account for you by default. This integration uses the email address associated with your Shopify account. This is a convenience feature designed to let you start making sales immediately, but it is often misunderstood by new merchants.
If you already have a PayPal account tied to that specific email, you might see funds appearing there as soon as you make your first sale. However, if you do not have an account, or if your account is a personal one, you will face limitations. PayPal requires a professional business account to handle the high volume of transactions typical of e-commerce.
A common issue occurs when a merchant uses a different email for their business operations than they do for their Shopify login. In this scenario, the "automatic" setup sends payment notifications to an email address that might not be monitored or linked to a financial institution. Verifying which email is currently active in your payment settings is the first step toward a stable checkout.
Transitioning to a PayPal Business Account
To utilize the full range of Shopify’s features, including the ability to issue refunds directly from your Shopify admin, you must use a PayPal Business account. Personal accounts are designed for peer-to-peer transfers and lack the API permissions required for deep integration with an e-commerce platform.
If your current account is personal, you can upgrade it through the PayPal dashboard. This process usually involves providing your legal business name, business type, and contact information. Once upgraded, you can link the account to Shopify to unlock advanced features like manual payment capture and automatic synchronization of tracking numbers.
Merchants should also be aware that only the store owner has the permission level required to edit PayPal Express information within Shopify. This is a security measure designed to protect your financial data. If you are an employee or a collaborator on a store, you will need the owner to log in and complete the final authentication steps.
Hide, sort, and rename Shopify payment methods using powerful conditions. Customize your checkout and control payment options with HidePay.
Step-by-Step Setup on Desktop
Completing the setup on a computer is the most common method for merchants. It allows for a clear view of the permissions being granted during the redirect to PayPal’s authentication page.
- Navigate to Settings: Log in to your Shopify admin and click on the "Settings" gear icon located at the bottom left of the screen.
- Open Payment Providers: Select "Payments" from the sidebar menu. This section lists all your active and available payment gateways.
- Locate the PayPal Section: In the "Additional payment methods" block, you will see a PayPal entry. If the setup is incomplete, there will be a button labeled "Complete setup" or "Activate PayPal Express Checkout."
- Authenticate the Connection: Click the activation button. Shopify will redirect you to a PayPal login screen. Enter the credentials for the business account you wish to use.
- Grant Permissions: Once logged in, PayPal will ask for permission to connect to Shopify. This allows the two platforms to share order data, process refunds, and sync payment statuses. Click "Agree and Connect" or "Grant Permission."
- Return to Shopify: After the connection is confirmed, you will be redirected back to your Shopify admin. The status should now show as "Active."
Once these steps are finished, it is important to check your payment authorization settings. You can choose to capture payments automatically at the time of the order or manually after you have reviewed the order.
Completing the Setup via the Shopify Mobile App
Many merchants manage their stores on the go. The Shopify mobile app provides a streamlined way to finalize your PayPal connection, though the steps are slightly different due to the interface.
- Access Store Settings: Open the Shopify app and tap the three-line menu or the "Store" icon. Navigate to "Settings."
- Enter Payments Menu: Select "Payments" from the list of store settings.
- Complete the Integration: Look for the PayPal module. If you see a "Setup incomplete" message, tap "Complete setup."
- Login and Confirm: The app will open a browser window for you to log in to PayPal. Ensure you are using the correct business credentials. Tap through the permission prompts.
- Finalize: Once the process is finished, the app will return you to the payments screen. Verify that the PayPal section no longer shows a setup warning.
Regardless of whether you use a desktop or mobile device, always perform a test transaction. Create a small test product priced at $1.00 and attempt to purchase it using a different PayPal account. This ensures that the flow from your storefront to the payment confirmation page is working as expected.
Managing Payment Authorization Settings
A critical decision during the PayPal setup is how you want to capture funds. Shopify offers two primary methods: automatic and manual capture.
Automatic Capture
This is the default setting. When a customer completes an order, the funds are immediately captured and moved to your PayPal balance. This is ideal for digital products or stores with high-stock reliability. It reduces administrative work but can be more complex if you need to cancel an order before it ships, as you may still incur non-refundable transaction fees from the payment processor.
Manual Capture
With manual capture, the payment is authorized but not taken immediately. You have a specific window (usually several days) to "claim" the money. This is a common strategy for merchants who sell custom goods or high-ticket items where fraud review is necessary. It allows you to verify that the item is in stock and that the order looks legitimate before finalizing the financial transaction.
To adjust these settings, go to the "Payment capture" section within the "Payments" settings of your Shopify admin. Note that this setting applies to all payment methods, not just PayPal.
Address and Language Logic at Checkout
PayPal Express Checkout behaves differently than standard credit card entries because it often uses data already stored in the customer's PayPal profile. This can lead to confusion regarding shipping and billing addresses.
By default, Shopify sends the shipping address provided by the customer to PayPal. PayPal then uses this to populate its own billing fields. Customers can change this during the PayPal login process by clicking "Change" next to their address, but the initial data passed from Shopify is almost always the shipping destination.
Language settings are handled similarly. Shopify attempts to tell PayPal which language to display based on the customer’s location and the store’s checkout settings. If the customer's location cannot be determined via their IP address, PayPal defaults to the business address listed in your Shopify general settings. Ensuring your business address is accurate in Settings > General is therefore important for providing a localized experience for international buyers.
Optimizing PayPal Visibility with HidePay
Using the tool we built, HidePay, you can create rules to hide or show PayPal based on the customer's cart. For example, if you sell a specific category of products that are frequently targeted by fraudulent claims, you can set a rule to hide PayPal as an option when those items are in the cart — learn how to create a payment customization.
You can also use the app to sort your payment methods. Many merchants prefer to have their primary credit card processor listed first and PayPal second. Sorting helps guide the customer toward the payment method that is most cost-effective for your business — see how to sort and rename payment methods.
HidePay is built on modern, native checkout logic; it integrates with Shopify using native functions so changes apply instantly without custom code — read more about Shopify Functions and how they differ from legacy scripts.
Troubleshooting Pending Payments
One of the most frequent complaints after a "successful" setup is that payments appear as "Pending" in the Shopify admin. This usually indicates that the payment was sent to an email address that hasn't been verified yet.
PayPal will not release funds to an unverified account. If you receive a pending payment notification, check the following:
- Email Verification: Log in to your PayPal account and ensure you have clicked the verification link sent to your inbox.
- Currency Match: If a customer pays in a currency you haven't enabled in your PayPal account, the payment may stay pending until you manually accept the currency and open a balance for it.
- Account Limitations: Sometimes, PayPal requires additional identity verification (KYC) before it allows you to receive funds. Check the "Resolution Center" in your PayPal dashboard for any outstanding requests.
Once you verify your email or resolve the account block, it can take up to two business days for the status in Shopify to update from "Pending" to "Paid." Do not ship the items until the payment is confirmed.
Handling Accelerated Checkout Buttons
PayPal Express often adds an "Accelerated Checkout" button to the top of your checkout page or even on product pages. While this can speed up the purchase process, it can also bypass important steps like custom checkout fields or terms and conditions checkboxes.
If you find that these buttons are hurting your conversion rate or leading to incomplete order data, you can manage them. You can deactivate the buttons in your theme's customization settings or use our app to block them based on specific rules — see how to hide PayPal Express buttons in checkout. For instance, you might want to allow the PayPal button for mobile users (who appreciate the speed) but hide it for desktop users to ensure they see your full checkout layout.
Managing these buttons is a key part of protecting your margins. By controlling the visibility of "Express" options, you ensure that the customer experience matches your operational requirements.
Testing and Validation
Before going live, you must ensure the integration is flawless. Shopify provides a specific environment for testing, but for PayPal Express, the best method is a real-world test.
- Use a Separate Account: You cannot buy a product from your own store using the same PayPal account that is set up to receive the payments. Use a personal account or ask a friend to help.
- Check the Redirect: Ensure that when you click the PayPal button at checkout, the redirect is fast and the branding matches your store.
- Verify the Return Trip: After the payment is authorized on the PayPal side, the customer must be redirected back to your Shopify "Thank You" page. If the loop breaks here, customers will be confused, and orders may not be recorded correctly.
- Confirm the Admin Record: Check your Shopify admin to see if the order was created and if the payment status is "Paid" (or "Authorized" if you chose manual capture).
If you need pre-checkout validation rules (for example, to block risky or incomplete purchases), consider using CartBlock on the Shopify App Store to validate or block orders before they reach payment.
If you are still on a Shopify trial, you will need to choose a plan before you can fully activate your checkout and process these test transactions. The trial remains free until its original end date, but the "Checkout" functionality is locked until a plan is selected.
Conclusion
Setting up PayPal on Shopify is more than just clicking a button; it requires intentional configuration to ensure your funds are accessible and your checkout is optimized. By upgrading to a business account, verifying your email, and selecting the right capture method, you create a professional foundation for your store.
To further refine this experience, using a tool like HidePay allows you to control the display of payment methods based on real-world business needs. Whether you need to hide PayPal for specific regions or reorder it to favor lower-fee gateways, taking control of your checkout is the best way to protect your profits.
If you want unified control of both payment and shipping logic, learn how the HideSuite bundle combines HidePay and HideShip to simplify management across both areas.
For merchants who need codeless Shopify Functions or custom checkout logic, check out SupaEasy on the Shopify App Store.
- Ensure your PayPal account is a Business type to handle refunds.
- Verify your email address immediately to avoid "Pending" payment issues.
- Choose between manual and automatic capture based on your fulfillment speed.
- Use rules to hide or sort payment methods to improve your conversion rate.
Ready to take full control of your Shopify checkout? You can view current pricing and start optimizing your payment methods by installing HidePay today.
FAQ
Why is my PayPal status showing as "Setup Incomplete" on Shopify?
This usually happens because you haven't finalized the connection between the two platforms. Even if your store email matches your PayPal email, you must click "Complete Setup" in your Shopify payment settings and grant the necessary API permissions to allow Shopify to manage transactions on your behalf.
Can I hide the PayPal button for specific products or countries?
Yes, you can manage the visibility of PayPal using our tool. By setting up geography-based or product-based rules, you can hide PayPal for regions where it isn't preferred or for specific items that carry a higher risk of chargebacks, ensuring a safer and more profitable checkout experience.
Why do my PayPal payments show as "Pending" in my Shopify admin?
Payments typically stay pending if the email address used for the transaction has not been verified in your PayPal account. Log in to PayPal and check your notification center to ensure all verification steps are complete. It can also happen if you are receiving a currency that you haven't yet enabled in your PayPal balance.
Does PayPal Express Checkout automatically collect the customer's billing address?
PayPal generally uses the shipping address provided by Shopify to fill its billing fields. While customers can manually change their billing address during the PayPal login process, Shopify only sends one address (the shipping address) to the PayPal interface. This is a standard behavior of the Express Checkout integration.