How to Test Payment Gateway Shopify Settings Properly

Introduction

Testing your Shopify payment gateway ensures that your customers can complete their purchases without friction. A broken checkout is the fastest way to lose a sale, so verifying your payment setup is a non-negotiable step for any merchant. Whether you are launching a new store or updating your current payment options, running simulated transactions confirms that your settings for taxes, shipping, and notifications are working exactly as intended.

During this testing phase, it is also the ideal time to consider how your payment methods are presented to the customer. While Shopify provides the infrastructure for transactions, we built HidePay on the Shopify App Store to give you control over which methods appear and in what order. Verifying your gateway's connectivity is the first step; optimizing the checkout layout to drive conversions is the second.

This guide provides the technical steps to test Shopify Payments and the Bogus Gateway. You will learn how to simulate successful and failed transactions, troubleshoot common issues, and ensure your checkout is ready for live traffic.

Why You Must Place Test Orders

Placing a test order is about more than just checking if a credit card works. It is a full-system check for your e-commerce operations. When you run a test transaction, you are verifying that your inventory levels update correctly after a sale. You are also ensuring that your shipping rules trigger the right rates and that your tax settings comply with local regulations.

Testing also allows you to see the automated emails your customers receive. If the formatting is off or the links do not work, you can fix these issues before a real customer sees them. Merchants who skip this step often discover errors only after receiving complaints or losing revenue. By simulating various scenarios, you protect your brand reputation and ensure a professional experience from the first click to the final confirmation.

Testing with Shopify Payments Test Mode

If you use Shopify Payments, you have access to a built-in test mode. This feature allows you to simulate transactions using specific test card numbers without moving real money. It is the most accurate way to see exactly what your customers see.

To enable this, go to your Shopify admin and navigate to Settings, then Payments. In the Shopify Payments section, select "Manage." Scroll down to the Test Mode section, check the box for "Enable test mode," and save your changes. Once this is active, your store will display a banner indicating that it is in test mode.

Simulating Successful Transactions

To verify that your checkout flow is functional, you should simulate a successful purchase. Use any future expiry date and a random three-digit CVV. For the "Name on card," enter at least two words. Use the following test card numbers to simulate different card types:

• Visa: 4242 4242 4242 4242
• Mastercard: 5555 5555 5555 4444
• American Express: 3782 8224 6310 005
• Discover: 6011 1111 1111 1117

Simulating Failed Transactions

It is equally important to know what happens when a payment fails. You need to ensure the error messages are clear so customers know how to fix the issue. Use these numbers to trigger specific responses:

• Card Declined: 4000 0000 0000 0002
• Incorrect Number: 4242 4242 4242 4241
• Disputed Transaction (Chargeback): 4000 0000 0000 0259
• Insufficient Funds: 4000 0000 0000 9995

When testing these, look at the checkout UI. Does the error message appear clearly? Does it encourage the customer to try another method? This is where our tool helps by allowing you to rename payment methods. If a specific gateway frequently fails or has high fees, you might rename it to "Credit/Debit Card (Standard)" to set better expectations or prioritize a more reliable method at the top of the list. See the HidePay guide on how to sort and rename payment methods in the checkout for step-by-step instructions.

Using the Shopify Bogus Gateway

If you are not using Shopify Payments or want to test a third-party setup, the Bogus Gateway is the standard alternative. This is a "dummy" provider that simulates the transaction process for any store.

To set this up, go to Settings and then Payments. If you have a credit card provider active, you must deactivate it first. Then, look for "See all other providers" or "Choose a provider" and select "(for testing) Bogus Gateway." Once activated, you can place orders on your site using these specific inputs:

1. Card Number: Enter "1" for a successful transaction.
2. Card Number: Enter "2" for a failed transaction.
3. Card Number: Enter "3" for a provider exception (system error).
4. Name on Card: Enter "Bogus Gateway."
5. CVV: Enter any 3-digit number.
6. Expiry Date: Enter any date in the future.

The Bogus Gateway is particularly useful for international merchants who want to test how their store handles different currencies or regional tax calculations without involving real banking institutions.

Testing Shop Pay and Express Buttons

Express checkout options like Shop Pay, Apple Pay, and Google Pay often bypass parts of the standard checkout flow. While Shopify Payments test mode is active, you can test Shop Pay by using the standard test card numbers mentioned earlier.

When adding a test card to Shop Pay, enter "test_card" in the Nickname field. This tells the system to process it as a simulated transaction. However, be aware that some express buttons like PayPal Express may still attempt real charges if not configured correctly in a sandbox environment.

Many merchants find that express buttons clutter the top of the checkout, distracting customers from their preferred payment methods. In these cases, we recommend using the app to create rules that hide specific express buttons based on the customer’s location or the contents of their cart. For instructions on hiding dynamic checkout buttons, consult the HidePay help article on how to hide dynamic checkout buttons.

Verifying Checkout Rules and Sorting

Testing a payment gateway is not just about the connection; it is about the presentation. Once you know the gateway works, you must test how your payment methods appear to different types of customers. If you use HidePay to manage your checkout, your testing process should include verifying these specific logic rules.

Testing Geographic Rules

If you sell internationally, you likely want to show different payment methods to different countries. For instance, you might want to show iDEAL only to customers in the Netherlands or hide Cash on Delivery (COD) for customers in regions where shipping is too expensive to risk a refusal.

To test this:

1. Set up your rule in our app to hide a specific method for a target country.
2. Use a VPN or change your shipping address at checkout to that country.
3. Verify that the payment method appears or disappears as expected.
4. Confirm that the "native" performance of the checkout remains fast, as the app is built on Shopify Functions.

For guidance on organizing payment methods by country or Shopify Market, see the help article on organizing payment methods by country or market.

Testing Cart Attribute Rules

You may want to hide specific high-fee payment methods if the cart total is below a certain threshold. Alternatively, you might want to sort a specific gateway to the top of the list for high-ticket items to reduce chargeback risks.

To test this:

1. Add items to your cart that meet your rule's criteria (e.g., a total over $500).
2. Check the order of the payment methods.
3. Add or remove items to see if the sorting updates dynamically.
4. Verify that the renaming of methods (e.g., changing "Bank Deposit" to "Direct Wire Transfer") displays correctly.

See the HidePay help doc on how to create a payment customization for details on creating Cart Total and other condition types.

Testing Real Transactions

Once you have finished with simulated tests, we recommend performing one real transaction with a genuine credit card. This is the ultimate "smoke test" to ensure your bank and Shopify are communicating perfectly.

1. Disable test mode in your Shopify admin.
2. Purchase a low-priced item from your store using your own credit card.
3. Verify that the payment is captured in your payment provider's dashboard.
4. Cancel and refund the order immediately.

Note that while the transaction is real, your payment processor may still charge a small, non-refundable transaction fee. This is a small price to pay for the peace of mind that your live store is fully functional.

Troubleshooting Common Testing Issues

Sometimes a test order does not behave as expected. Most issues stem from settings within the Shopify admin or regional restrictions.

Orders Not Appearing in Reports

If you are looking for your test orders in your sales reports and cannot find them, don't worry. Shopify excludes test mode transactions and Bogus Gateway orders from your financial reports and payouts. This ensures your data remains accurate and isn't skewed by your internal testing.

Confirmation Emails Not Sending

If you complete a test order but do not receive a notification, check your "Notifications" settings. If you have customized your email templates, a coding error might be preventing them from sending. You can revert to the default template to see if that resolves the issue. Also, check your spam folder, as many test emails are flagged by filters.

Local Payment Methods Missing

Local methods like Sofort, iDEAL, or Klarna often do not appear when Shopify Payments is in test mode. These require real-time communication with external banks that cannot always be simulated. To test these, you may need to use a real transaction and then refund it. If you are using our tool to manage these methods, ensure your rules are not accidentally hiding them for your testing location.

For additional troubleshooting on retrieving the correct payment method reference in the app, consult the help article how to retrieve the correct payment method in HidePay.

Checkout Loading Slowly

If your checkout feels sluggish during testing, check if you are using outdated "Script Editor" scripts. Modern Shopify stores should move toward native Shopify Functions for better performance. Our app uses these native functions, meaning your payment rules are processed on Shopify’s own infrastructure, preventing the lag often associated with older workarounds.

To learn more about the philosophy behind migrating from scripts to functions, read the Nextools blog post Why Shopify Functions are the future and scripts are the past.

Transitioning to a Live Store

After you have verified that your gateways work and your checkout rules are firing correctly, you must prepare for launch. The most important step is to deactivate test mode. If you leave it on, real customers will be able to "pay" with test card numbers, and you will not receive any actual funds for those orders.

Review your payment method sorting one last time. Does the layout lead the customer toward the lowest-fee or highest-conversion option? We recommend placing your most trusted and widely used gateway at the top. Use the app to rename any cryptic gateway names to something clear and recognizable, like "Credit Card (Visa, Mastercard, Amex)."

If you are also managing shipping methods, consider the related Nextools resources about optimizing the checkout experience—see the blog post introducing the HideSuite bundle for smart Shopify merchants for options that combine payment and shipping method controls.

Key Steps for a Successful Test

To ensure you haven't missed anything, follow this checklist during your testing process:

• Verify Success: Use a test card to complete a full order and check the "Thank You" page.
• Verify Failure: Trigger at least one "Card Declined" message to see the customer experience.
• Check Notifications: Ensure the order confirmation email contains the correct order details.
• Test Mobile: Complete a test purchase on a mobile device to check the UI of the payment list.
• Review Rules: If you have hidden or sorted methods using HidePay, ensure they behave correctly for different customer tags or countries.
• Disable Test Mode: Confirm that "Enable test mode" is unchecked before driving real traffic.

Optimizing your checkout is a continuous process. As you expand into new markets or add new products, you should revisit these tests. Testing ensures the technical foundation is solid, while our tool ensures the presentation is optimized for your specific business goals.

Summary of Testing Outcomes

By the end of your testing session, you should be confident in three areas: technical reliability, operational readiness, and user experience. Technical reliability means the gateway captures data correctly. Operational readiness means your staff receives the order and inventory is deducted. User experience means the customer sees a clean, organized list of payment options that makes sense for their location and order type.

We believe that a "smart" checkout is one where the merchant has total control. By using native tools to hide irrelevant options and surface the best ones, you reduce cart abandonment and protect your margins from high-transaction-fee methods.

Start by installing HidePay — free to install to see how easily you can organize your checkout methods. Once you have your rules in place, follow the testing steps above to ensure a flawless experience for your customers.

FAQ

Why can't I see my local payment methods like Klarna in test mode?

Shopify Payments test mode is designed to simulate credit card transactions. Many local or regional payment methods (like Klarna, iDEAL, or Sofort) require a direct connection to a banking portal that is not active in test mode. To test these, you usually need to perform a real transaction with a live account and then issue a refund.

Will placing test orders affect my Shopify analytics and sales data?

No, orders placed using Shopify's Bogus Gateway or the Shopify Payments test mode do not appear in your financial reports, payouts, or sales analytics. This allows you to test your checkout as many times as needed without inflating your revenue numbers or messing up your conversion rate data.

Can I test my payment gateway on a development store?

Yes, development stores can process unlimited test orders. However, you cannot use real transactions on a development store. If you need to test a real credit card and then refund it, you must first move your store to a paid Shopify plan.

How do I test if my payment hiding rules are working?

After setting up a rule in our app (for example, hiding a payment method for a specific zip code), go to your storefront and act as a customer. Enter a shipping address that matches the rule's criteria. If the payment method disappears as intended, the rule is active. Because the app uses native Shopify Functions, these changes happen instantly without slowing down the checkout.

For more help articles and tutorials, visit the HidePay Help Docs index.