Voltar a Guias de Pagamento

How to Connect Payment Gateway to Shopify for Better Conversion

Learn how to connect payment gateway to Shopify with our step-by-step guide. Compare Shopify Payments vs. third-party providers and optimize for better conversions.

Introduction

Connecting a payment gateway to your Shopify store is the most critical step in moving from a setup phase to a live, revenue-generating business. This connection acts as the bridge between your customer’s bank account and your own, ensuring that funds are captured securely and efficiently. Whether you are using Shopify's native tools or a third-party provider, the process is designed to be straightforward and accessible through your admin dashboard.

Selecting the right gateway involves balancing transaction fees, geographic availability, and the specific needs of your customer base. Once the technical connection is established, tools like HidePay on the Shopify App Store allow you to refine how these options appear to your customers, ensuring a clean and high-converting checkout experience. By tailoring which methods appear to which customers, you can reduce friction and protect your profit margins.

This article provides a step-by-step walkthrough of how to connect payment gateway to shopify, covering everything from Shopify Payments to third-party integrations and alternative methods. You will learn how to configure these settings, manage regional requirements, and optimize the final checkout display for maximum efficiency.

Understanding Your Gateway Options

Before you begin the technical setup, you must decide which type of gateway best suits your business model. Shopify categorizes payment connections into three main groups: Shopify Payments, third-party providers, and alternative payment methods.

Shopify Payments is the platform’s own integrated solution. It is often the preferred choice because it eliminates third-party transaction fees and allows you to manage your finances directly within the Shopify admin. However, it is not available in every country. If your business is based in a region where Shopify Payments is unsupported, or if your industry is considered high-risk by their underwriters, you will need to look at third-party providers.

Third-party providers are independent gateways like Stripe, Authorize.net, or local favorites like Razorpay in India. While these require a separate account and often come with additional per-transaction fees from Shopify, they offer specialized services and broader geographic reach. Finally, alternative payment methods include "Buy Now, Pay Later" (BNPL) services like Klarna or digital wallets like PayPal and Apple Pay. Most successful stores use a combination of these to offer customers the flexibility they expect.

How to Set Up Shopify Payments

If you are eligible for Shopify Payments, it is generally the fastest way to start accepting credit cards. Because it is built into the platform, the connection is pre-established; you simply need to provide your business details to activate it.

Step-by-Step Activation

  1. Log in to your Shopify admin and navigate to Settings, then click Payments.
  2. If you see a section for Shopify Payments, click Activate Shopify Payments or Complete account setup.
  3. Enter your business type (e.g., LLC, Sole Proprietorship) and your Employer Identification Number (EIN) or relevant tax ID for your region.
  4. Input your personal details, including your home address and the last four digits of your Social Security number (in the US) or equivalent identification.
  5. Provide your product details by giving a brief description of what you sell and how you ship it.
  6. Enter your banking information, including the routing number and account number where you want your payouts deposited.

Once you submit this information, Shopify will review your application. In many cases, you can start accepting payments immediately, though some accounts may require a "Proof of Liveness" check or additional documentation to verify your identity.

Key Takeaways for Shopify Payments

  • No Transaction Fees: Using Shopify Payments removes the 0.5% to 2% transaction fee Shopify charges for third-party gateways.
  • Integrated Reporting: View your payouts and individual transaction fees directly in the "Finances" section of your admin.
  • CVV and Zip Code Verification: These security features are built-in and help reduce the risk of fraudulent chargebacks.
Personalizar os Shopify Payments facilmente

Oculte, ordene e renomeie os métodos de pagamento do Shopify usando condições poderosas. Personalize o seu checkout e controle as opções de pagamento com o HidePay.

Connecting a Third-Party Payment Gateway

If Shopify Payments is not an option for your store, or if you prefer a specific provider for their lower rates or better local support, you will need to connect a third-party gateway. Shopify integrates with over 100 providers worldwide, but you can only have one primary credit card provider active at a time.

Steps to Connect a Third-Party Provider

  1. From your Shopify admin, go to Settings > Payments.
  2. If Shopify Payments is not active, look for the Payment providers section and click Choose a provider.
  3. If you currently have Shopify Payments active and want to switch, click Manage within the Shopify Payments section, scroll to the bottom, and select Switch to a third-party provider.
  4. Use the search bar to find your gateway (e.g., Worldpay, Stripe, or Braintree).
  5. Enter your account credentials. This usually involves an API Key, a Merchant ID, or a Secret Token provided by your gateway's own dashboard.
  6. Click Activate and then Save.

Before going live, it is vital to contact your chosen provider to ensure your account is fully approved for e-commerce transactions. Simply entering the credentials in Shopify does not guarantee the provider has cleared your account for processing.

What to Do Next:

  • Locate API Credentials: Log in to your payment provider's dashboard to find your specific integration keys.
  • Check Currency Support: Ensure the provider supports the settlement currency you have set in your Shopify store.
  • Verify Regional Address: Ensure your store address in Settings > General matches the region supported by the gateway, or it may not appear in the search results.

Adding Alternative Payment Methods

A primary credit card gateway is essential, but it is rarely enough to maximize conversions. Customers increasingly prefer "express" options or deferred payment plans. These are added separately from your main credit card provider.

Integrating Wallets and BNPL

Digital wallets like PayPal, Apple Pay, and Google Pay often see the highest conversion rates because they remove the need for customers to type in their card details and shipping addresses manually. BNPL options like Affirm, Sezzle, and Klarna are also effective for stores with higher average order values.

To add these, go to the Additional payment methods section in your Payments settings. You can click Add payment methods and search by the specific name of the service or the provider. Many of these integrations now function as "apps" within the Shopify ecosystem. When you select them, you may be prompted to install an integration app from the Shopify App Store to complete the connection.

Once installed, you must manage the app settings to link your external account. After the link is verified, the option will automatically appear on your checkout page alongside your standard credit card gateway.

Managing Region-Specific Gateways

If you sell internationally, a one-size-fits-all payment strategy often fails. For example, customers in the Netherlands prefer iDEAL, while those in Brazil look for Pix or Boleto. Connecting these regional gateways follows the same logic as adding alternative payment methods, but requires more attention to your store's "Markets" settings.

When you connect a regional gateway, it typically only appears to customers whose shipping address matches the gateway’s supported region. However, sometimes gateways overlap or create a cluttered checkout. This is where we recommend using rules-based logic to keep the interface clean. For a step-by-step walkthrough on organizing payment methods by country or market, see the guide on organizing payment methods by country or Shopify Market.

By default, Shopify displays all active gateways to all eligible customers. This can lead to a "wall of buttons" that overwhelms the shopper. In our experience, merchants who curate their payment list based on the customer’s country see higher completion rates. You can achieve this by setting rules that hide specific gateways for countries where they aren't popular, ensuring the most relevant options are front and center.

Optimizing the Payment Experience

Simply knowing how to connect payment gateway to shopify is only half the battle. The true value lies in how you present those connections to your customers. Once your gateways are connected, you need a strategy to manage them.

Sorting for Conversion

The order in which payment methods appear matters. If your most profitable gateway (the one with the lowest fees) is buried at the bottom of the list, you are losing money on every transaction. By reordering your payment methods, you can guide customers toward the options that are best for both of you. For instructions on reordering and renaming payment options, consult the help article on sorting and renaming payment methods in the checkout.

Hiding Redundant Options

Sometimes, you might want to restrict certain payment methods based on what is in the cart. If you are selling high-risk items or digital downloads, you might want to hide "Cash on Delivery" to prevent fraud. Similarly, if a cart total is very low, you may want to hide BNPL options because the processing fees might be too high relative to the profit margin. The HidePay help doc on hiding payment methods by cart attributes shows how to target cart-level conditions.

Renaming for Clarity

The default names provided by gateways aren't always customer-friendly. You might want to rename "Bank Deposit" to "Wire Transfer" or add a note like "Credit Card (Secure via Stripe)" to build trust. Clear labels reduce hesitation at the final step of the buying journey.

We built our app to handle these exact scenarios. Within the tool, you can create logic that sorts, renames, or hides payment methods based on a wide variety of conditions, such as cart total, customer tags, or delivery method. See the help page on how to create a payment customization for a guided walkthrough. This level of control ensures your checkout remains professional and optimized for profit.

Protecting Your Margins and Reducing Risk

Connecting a gateway is an invitation for transactions, but not all transactions are beneficial. High processing fees, chargeback risks, and fraudulent orders can quickly erode your success. Your payment connection strategy should include protective measures.

For B2B merchants, the payment needs are vastly different from D2C. You might want to offer "Net 30" or "Purchase Order" options only to customers who have a specific "Wholesale" tag in your system. By using rules to show these gateways only to verified business partners, you keep your standard checkout clean for retail customers while providing the necessary flexibility for your bulk buyers.

Furthermore, we suggest monitoring the performance of each gateway. If you notice a specific provider has a high rate of technical failures or attracts a disproportionate number of chargebacks, you should use conditional logic to restrict its availability. For instance, you could hide a problematic gateway for orders over a certain dollar amount or for specific high-risk geographic regions.

Using Shopify Functions for Customization

The technical landscape of Shopify checkout has changed. Previously, deep customization required complex "Scripts" that were difficult to maintain and only available to Shopify Plus merchants. Today, we utilize Native Shopify Functions to handle payment customizations.

Because HidePay is built on these native functions, it runs directly within Shopify's infrastructure. This means there are no external scripts slowing down your checkout and no theme code edits required. It is a more robust, secure, and faster way to manage how your connected gateways behave. Whether you are hiding PayPal Express for certain products or reordering your credit card options, these changes happen instantly and reliably. For more on migrating from Scripts to functions and function-based tools, check out the Nextools blog index on checkout customization and Functions.

If you need a tool to build or migrate Shopify Functions for advanced cases, consider SupaEasy on the Shopify App Store which helps generate and migrate functions without heavy development.

Testing Your Payment Connection

Never assume a gateway is working just because it says "Active." Before directing traffic to your store, you must perform a test transaction. There are two primary ways to do this without spending actual money.

The Bogus Gateway

Shopify provides a "Bogus Gateway" for testing. This is a simulated provider that allows you to go through the entire checkout process using specific test card numbers. It is excellent for verifying that your shipping rates, taxes, and email notifications are triggering correctly.

Test Mode on Live Gateways

Most major providers, including Shopify Payments, offer a "Test Mode." When enabled, you can use test card numbers (like those provided in the gateway's documentation) to simulate a successful or failed transaction.

  • Success Test: Use the successful test card to ensure the order flows into your "Orders" list.
  • Failure Test: Use a "declined" test card to see how the error message appears to your customers.
  • Refund Test: Practice refunding the test order to understand how the gateway handles returns.

Important: Remember to disable Test Mode before you start marketing your store, or real customers will not be able to complete their purchases.

If you run into issues identifying a payment method or seeing unexpected behavior during testing, the article on how to retrieve the correct payment method in HidePay explains how to use the app's logs to debug common problems.

Summary Checklist for Merchants

  • Determine Eligibility: Check if Shopify Payments is available in your country.
  • Select Gateway: Choose between Shopify Payments or a third-party provider based on fees and risk.
  • Gather Credentials: Have your API keys or Merchant IDs ready from your provider dashboard.
  • Configure Additional Methods: Add PayPal, Apple Pay, and BNPL services to increase conversion.
  • Apply Logic: Use rules to hide, sort, or rename methods to suit your specific business needs.
  • Run a Test: Complete at least one transaction in Test Mode before going live.

Conclusion

Setting up and optimizing your payment gateway is a foundational part of running a successful online store. By following the steps to connect your primary and alternative providers, you ensure that customers can pay in the ways they prefer. However, simply connecting the gateway is not the end of the process.

To truly excel, you must take control of the checkout experience. Use the data available to you to sort your most effective gateways to the top and hide options that carry high fees or risks for specific orders. This level of precision protects your bottom line and creates a smoother experience for your shoppers.

Ready to take full control of your checkout? You can get HidePay for your store on the Shopify App Store to begin sorting, renaming, and hiding payment methods with ease. For an implementation walkthrough and examples, see the HidePay homepage and guides at HidePay — features and docs.

FAQ

Can I connect more than one credit card gateway to my Shopify store?

No, Shopify only allows you to have one primary credit card provider active at a time. This would be either Shopify Payments or a single third-party provider like Stripe or Authorize.net. You can, however, add multiple "additional" payment methods such as PayPal, Klarna, or Apple Pay alongside your primary provider.

Why isn't the payment gateway I want to use appearing in the list?

The list of available gateways is filtered based on the store address located in your Shopify admin under Settings > General. If a provider is not showing up, verify that your store's country and currency are supported by that specific gateway. You can also check the HidePay help resources for organizing gateways by region in the guide on organizing payment methods by country or Shopify Market.

Does Shopify charge extra fees for using a third-party gateway?

If you do not use Shopify Payments, Shopify charges an additional transaction fee on every order. This fee ranges from 0.5% to 2%, depending on your Shopify subscription plan. This is in addition to the processing fees charged by the third-party gateway itself, which is why many merchants prefer Shopify Payments when available.

How do I hide a payment method for specific products or customers?

Shopify does not have a native "toggle" to hide payment methods based on cart contents or customer tags. To do this, you need an app that utilizes Shopify Functions. Our help doc on hiding payment methods for specific products and the general guide on how to create a payment customization show the exact steps to create rules (cart total, product, customer tag, shipping method, and more).

Further reading and resources:

Need help installing? Follow the official installation guide: install HidePay Shopify app.

Começar a usar o HidePay

Oculte, organize e otimize os métodos de pagamento do Shopify instantaneamente, sem necessidade de código.