Introduction
A "pending" payment status for PayPal Express Checkout orders in your Shopify admin usually indicates that the transaction was sent to an unverified email address or a PayPal account that hasn't completed its setup. While the customer may see a successful transaction on their end, the funds remain in limbo until you take specific administrative actions. This delay can disrupt your fulfillment workflow and cause unnecessary anxiety for both you and your customers.
Managing these payment hurdles is a core part of maintaining a healthy checkout experience. At HidePay, we focus on giving merchants granular control over their checkout environment to prevent friction before it starts — if you want to get HidePay for your store, you can find it on the Shopify App Store.
This guide explains the technical reasons behind the pending status, provides step-by-step solutions to resolve it, and shares strategies for managing your payment gateways to avoid these issues in the future. By the end of this article, you will know exactly how to verify your account and automate your checkout logic for better performance. Read the announcement post to learn more about the app's goals and features in context.
Why Your Shopify Payment Is Pending on PayPal
The most frequent cause of a pending status is an unverified PayPal account. When you open a Shopify store, the platform automatically creates a PayPal Express Checkout entry using the email address you used to sign up for Shopify. If that email is not already linked to a verified PayPal Business account, the funds from any initial sales are held in a "pending" state.
Unverified Email Address
PayPal requires you to confirm your email address before they release funds into your balance. If a customer pays via PayPal before you have clicked the confirmation link in PayPal’s welcome email, Shopify will label the payment as pending. You must verify the email associated with the account to claim these funds. Once verified, it can take up to two business days for the balance to reflect in your account.
Personal vs. Business Accounts
Shopify requires a PayPal Professional or Business account to function correctly. If you are using a personal PayPal account, the integration may trigger pending statuses or limit your ability to issue refunds and capture payments manually. Upgrading to a Business account is a requirement for standard Shopify operations and usually takes only a few minutes through the PayPal settings menu.
Account Setup Incomplete
In your Shopify admin, you might see a "Setup incomplete" badge next to PayPal in the Payments section. This happens if the API connection between the two platforms hasn't been fully authorized. Even if the payment appears to have gone through on the customer's side, Shopify cannot update the order status to "Paid" until the handshake between the apps is finalized.
How to Fix Pending PayPal Payments
Resolving a pending status requires a sequence of checks within both your Shopify admin and your PayPal dashboard. Follow these steps to clear the pending status and ensure future payments are captured immediately.
1. Verify Your PayPal Email
Check the email address listed in your Shopify Store settings (Settings > General). Ensure this exact email is added and confirmed in your PayPal account. If you haven't received a confirmation email from PayPal, you can request a new one from your PayPal Profile settings. Do not mark orders as paid in Shopify until you see the funds "Completed" in your PayPal activity log.
2. Complete the Connection in Shopify
Navigate to the Payments section of your Shopify admin. If you see a "Complete setup" button in the PayPal section, click it. You will be redirected to a PayPal login page where you must grant Shopify permissions to access your account data and process refunds. Once you click "I Give Permission" and return to Shopify, the status should update.
3. Match Store and PayPal Country Settings
If your Shopify store is registered in one country but your PayPal account is registered in another, the activation may fail. PayPal often requires the business location to match across both platforms for security and tax compliance. Verify your store's country in the General settings page and ensure it aligns with your PayPal account profile.
4. Adjust Payment Authorization
In your Shopify payment settings, you can choose between "Automatically capture payments" and "Manually capture payments."
- Automatic: The system captures funds as soon as the order is placed.
- Manual: You must manually "Capture Payment" on the order page within a specific timeframe (usually 7 days for PayPal). If you have manual capture enabled, orders will stay in "Authorized" or "Pending" until you take action.
Hide, sort, and rename Shopify payment methods using powerful conditions. Customize your checkout and control payment options with HidePay.
Strategic Payment Management with HidePay
While PayPal is a globally recognized brand, it isn't always the best fit for every transaction or every region. Some merchants experience higher chargeback rates or more frequent "pending" delays with PayPal in specific markets. Using HidePay, you can create rules to control when PayPal Express Checkout appears to your customers; for example, you can hide payment methods based on zip codes to reduce verification delays.
You can also use the app to:
-
Sort Payment Methods: Move PayPal to the bottom of the list for high-ticket items where you prefer credit card payments.
- See the guide to sort and rename payment methods in the checkout.
-
Rename Gateways: Change the display name of PayPal to "PayPal & Credit Cards" to clarify the options for the customer.
- Watch the Hide, Sort or Rename Payment Methods video guide for a quick walkthrough.
-
Hide by Product Type: If you sell digital goods that have higher fraud risks on PayPal, you can hide the gateway for those specific products while keeping it active for physical goods.
- Learn how to hide payment methods for certain products.
Troubleshooting Common PayPal Errors
Beyond the pending status, several other errors can disrupt your checkout flow. Addressing these proactively prevents cart abandonment and keeps your conversion rate high.
Duplicate Invoice ID Error
If you run multiple Shopify stores using the same PayPal account, you may encounter the "Payment already processed for InvoiceID" error. This happens because Shopify sends order numbers like #1001 to PayPal. If Store A and Store B both send "1001," PayPal rejects the second one as a duplicate. To fix this, go to your Shopify "Settings > Store details" and add a unique prefix or suffix to your order numbers (e.g., "STORE-A-1001").
Gateway Error: Too Many Requests
This error indicates that your store is sending too much data to PayPal in a short window, often during a high-traffic flash sale. PayPal may temporarily suspend the connection for 24 hours to prevent a brute-force attack. If this happens, you should contact PayPal support to whitelist your store or wait for the cooling-off period to end.
Refund Permission Denied
If you try to refund a customer through Shopify and get a permission error, the API link has likely expired or was never fully authorized. The solution is to deactivate PayPal in your Shopify Payments settings and then immediately reactivate it. This refreshes the "grant permission" token and allows Shopify to communicate with PayPal's refund API again.
Missing Billing Address
PayPal Express Checkout is an "accelerated" checkout. This means it often pulls the shipping address and uses it as the billing address automatically. If your store relies on strict billing address verification for fraud prevention, this can be a hurdle. While you cannot change how PayPal handles this data, you can use rules within our app to hide PayPal for customers who select "In-store pickup," where billing address discrepancies are more common — here's how to hide payment methods for Local Pickup.
Optimizing the PayPal Checkout Experience
To minimize the number of orders that end up in a pending state, you should optimize how PayPal interacts with your checkout. A clean, predictable checkout reduces the "support debt" of manually checking PayPal every morning.
Language and Currency Matching
Shopify attempts to detect the customer's location to inform PayPal which language to display. However, if the customer's IP address and shipping address conflict, PayPal defaults to the address found in your "General" settings. Ensuring your business address is accurate in the Shopify admin helps PayPal present the correct localized experience to the user.
Testing Your Integration
Never assume the integration is working perfectly just because the button appears. To test PayPal Express Checkout, you must use a different PayPal account than the one receiving payments. Create a test product for $1.00 and complete a real transaction. Check if the payment status in Shopify moves from "Pending" to "Paid" instantly. If it stays "Pending," re-check your email verification status.
Action Plan for Merchants
If you are currently facing pending payments, follow this sequence:
- Log in to PayPal and check for "Unclaimed" or "Pending" transactions.
- Verify the email address in your PayPal profile.
- Check Shopify Payments settings for the "Setup incomplete" message.
- Confirm the account type is set to Business/Professional.
For more background on how merchants use HidePay to avoid these issues and optimize checkout flows, see our announcement post about the app and the HideSuite bundle.
Managing Checkout Friction
A pending payment isn't just a technical glitch; it is a friction point. When a customer sees that their payment is "pending" in their account history, they may contact your support team or, worse, attempt to cancel the order.
By using the rules available in our app, you can ensure that PayPal is only presented when it is the most efficient option. For instance, you might choose to show PayPal only for orders under a certain dollar amount where the risk of a long-held "pending" status is more manageable. For high-value orders, you might prioritize gateways that offer immediate capture and higher security.
Nextools designed HidePay to run on native Shopify Functions, meaning these rules apply instantly without slowing down your checkout. If you want to explore no-code Shopify Functions tooling, check out SupaEasy — a codeless Shopify Functions creator that helps you migrate and generate native functions quickly.
Conclusion
A pending status on PayPal Express Checkout is a solvable issue rooted in account verification and API authorization. By ensuring your email is confirmed, your account is set to Business, and your Shopify permissions are up to date, you can eliminate the majority of payment delays. Managing your checkout environment with precision ensures that these technical hurdles don't impact your customer's experience or your store's reputation.
Key Takeaways:
- Verify your email: The most common cause of pending payments is an unconfirmed PayPal email address.
- Use a Business account: Shopify requires a PayPal Business or Professional account for full functionality.
- Check for "Setup Incomplete": Always ensure the API handshake in your Shopify admin is finished.
- Use rules to reduce risk: Use HidePay to show or hide PayPal based on geography, order value, or product type to avoid problematic transactions.
Ready to take full control of your checkout? install HidePay from the Shopify App Store today and start building a smarter, more efficient payment flow.
FAQ
Why does my Shopify order say "Payment Pending" for PayPal?
This usually happens because the payment was sent to an email address that hasn't been verified in PayPal yet. It can also occur if you are using a Personal PayPal account instead of a Business account, or if you have set your payment capture settings to "Manual" in your Shopify admin.
How long does a pending PayPal payment take to clear on Shopify?
Once you verify your email or complete the account setup, it typically takes up to two business days for the funds to move from "Pending" to your available balance. If the status is "Authorized" but not "Paid," you may need to manually capture the payment within your Shopify order screen.
Do I need a PayPal Business account for Shopify?
Yes, Shopify requires a PayPal Business or Professional account to handle features like automated refunds and manual payment captures. If you currently have a personal account, you can upgrade it through the PayPal settings menu without needing to create a brand-new account.
How do I stop PayPal from staying pending for every order?
Ensure your PayPal and Shopify emails match and are both verified. Then, go to Settings > Payments in Shopify and ensure the PayPal setup is marked as complete. If the problem persists, check that your "Payment Authorization" is set to "Automatically capture payments for orders."