Testing Your Checkout With the Bogus Payment Gateway on Shopify

Introduction

Testing your checkout is a non-negotiable step in maintaining a professional Shopify store. Every update to your shipping rates, tax settings, or payment logic carries the risk of unintended friction. Simulating transactions allows you to identify these issues before they impact your conversion rate or customer trust.

Shopify provides a sandbox environment specifically for this purpose. The Bogus Gateway is a simulated payment provider that allows you to walk through the entire purchasing journey without using real money or a live credit card. By using this tool alongside [HidePay on the Shopify App Store](HidePay: Hide Payment Methods), you can verify that your custom payment rules and sorting logic are performing exactly as intended for different customer segments.

This article covers how to activate the Bogus Gateway, the specific card numbers required to trigger different transaction outcomes, and how to transition from testing to a fully optimized live checkout. Whether you are launching a new store or refining a complex international setup, these steps ensure your payment processing is robust and reliable.

Understanding these testing protocols helps you build a checkout that converts.

Understanding the Bogus Payment Gateway on Shopify

The Bogus Gateway is a built-in Shopify tool designed to simulate the transaction lifecycle. Unlike a real payment processor, it does not communicate with a bank or charge any fees. It is a purely internal simulation that lets you move an order from "Pending" to "Paid" or "Failed" within your Shopify admin.

Using this gateway is essential because it triggers the same backend processes as a real order. When you "pay" with a bogus card number, Shopify still calculates taxes, updates inventory levels, and sends out order confirmation emails. This makes it the ideal environment to test your entire fulfillment workflow.

There are two primary ways to test payments on Shopify: the Bogus Gateway and Shopify Payments Test Mode. While both serve a similar purpose, the Bogus Gateway is a universal option available to almost any merchant, regardless of their location or whether they use Shopify Payments. It is particularly useful for testing checkout customizations built on Native Shopify Functions, as it provides a clean environment to see how payment methods are hidden or renamed based on specific cart conditions.

How to Activate the Bogus Gateway

To begin testing, you must first enable the gateway in your payment settings. This process involves temporarily deactivating your current credit card provider. Because this change affects your live checkout, we recommend performing these tests during low-traffic periods or on a development store.

Step 1: Access Payment Settings

Navigate to your Shopify admin and select the Settings menu. From there, click on Payments. This section displays all your active payment providers, including credit card processors, digital wallets, and manual methods.

Step 2: Deactivate Active Providers

If you already have a payment provider like Shopify Payments or a third-party gateway active, you must deactivate it first. Click Manage next to your current provider, scroll to the bottom, and select Deactivate. You will be asked to confirm this action. Note that while a provider is deactivated, customers cannot use it to complete purchases.

Step 3: Choose the Bogus Gateway

Once your primary provider is inactive, look for the section labeled "Payment providers." If you do not see a list of options, click "See all other providers" or "Choose a provider." Search the list for "(for testing) Bogus Gateway" and select it.

Step 4: Activate and Save

After selecting the gateway, click the Activate button. Ensure you save your changes. Your store is now in a simulated state where you can place orders using test credentials.

Action Steps for Activation:

• Log in to your Shopify admin during a scheduled maintenance window.
• Document your current payment provider settings before deactivating.
• Enable the Bogus Gateway to begin the simulation.
• Keep a separate browser tab open to your storefront to verify the checkout appearance.

Simulating Transaction Outcomes

The power of the Bogus Gateway lies in its ability to simulate specific results based on the input data. You do not need a real credit card number; instead, you use simple digits to tell Shopify how the "bank" should respond.

Successful Transactions

To simulate a successful purchase, enter "1" in the credit card number field. For the name on the card, use any text (e.g., "Test User"). The CVV can be any three-digit number, such as "111," and the expiry date must be any date in the future. When you click "Pay now," the order will be processed immediately as a paid transaction.

Declined Transactions

Testing how your store handles failure is just as important as testing success. Enter "2" in the credit card number field to simulate a declined card. This allows you to see the exact error message a customer would receive. It is an excellent way to verify that your checkout remains user-friendly even when a payment fails, encouraging the customer to try a different card rather than abandoning the cart.

Gateway Exceptions

If you want to see what happens when there is a technical error between Shopify and the payment provider, enter "3" in the credit card number field. This triggers an "exception" message. This is useful for testing your internal processes, such as whether your team receives notifications for failed payment attempts or how the order appears in your "Abandoned Checkouts" list.

Shopify Payments Test Mode

If your store uses Shopify Payments, you have access to a more advanced testing environment called Test Mode. This is often preferred over the Bogus Gateway because it allows you to test specific card brands, such as Visa, Mastercard, or American Express, which can have different processing behaviors.

Activating Test Mode

Unlike the Bogus Gateway, Test Mode is a toggle within the Shopify Payments settings. Go to Settings > Payments, click Manage on the Shopify Payments block, and find the "Test mode" section. Check the box for "Enable test mode" and save.

Using Test Card Numbers

When Test Mode is active, you use specific strings of numbers to simulate different card types. For a successful Visa transaction, use the card number "4242 4242 4242 4242." For Mastercard, use "5555 5555 5555 4444."

This level of detail is helpful if you are using HidePay to sort or rename payment methods based on the card type. For instance, if you want to ensure that credit card options are positioned above digital wallets, Test Mode provides a more realistic visual representation of the final checkout.

Simulating Regional Failures

Shopify Payments Test Mode also supports simulating failures like insufficient funds or expired cards. Using the number "4000 0000 0000 0002" will generate a generic decline, while "4000 0000 0000 0069" simulates an expired card. These scenarios help you audit the customer experience and ensure your checkout messaging is clear and helpful.

Testing Optimized Checkout Rules

A functional checkout is the baseline, but an optimized checkout is what drives growth. Once you have the Bogus Gateway running, you should test the logic that governs which payment methods appear and in what order. This is where you can verify that your payment strategy aligns with your business goals.

Geography-Based Rules

Many merchants choose to hide certain payment methods in specific regions. For example, you might want to hide Cash on Delivery (COD) for international orders while keeping it available for local customers. By using the Bogus Gateway and changing your shipping address at checkout, you can verify that your rules correctly hide the COD option the moment a foreign address is entered. For step-by-step guides on country-based rules, see the HidePay help docs index.

Cart Total and Product Rules

You may want to restrict certain payment methods, like "Buy Now, Pay Later" (BNPL), for very small orders to avoid high transaction fees. Conversely, you might hide high-risk payment methods for high-value orders to reduce chargeback exposure. Use the test gateway to build carts of varying values and confirm that the payment options dynamically update based on the total. For examples such as hiding COD for expensive orders or hiding payments by cart total, consult the HidePay guide on how to hide payment methods for a specific city and country which also shows how to combine multiple location-based conditions.

Sorting for Conversion

The order in which payment methods appear significantly impacts customer choice. Merchants often use our app to move their preferred, low-fee gateway to the top of the list. When testing with the Bogus Gateway, pay close attention to the visual hierarchy. Ensure your primary credit card gateway is the most prominent option to reduce decision fatigue for the shopper. If you run into payment methods that share the same name (for example, multiple Shopify Payments entries), follow the help article on how to sort payment methods with the same name to control ordering precisely.

Why Testing Matters for Shopify Functions

Shopify recently transitioned from the old Script Editor to Native Shopify Functions. This shift is significant because Functions run natively on Shopify's infrastructure, providing better performance and reliability. HidePay is built entirely on these Native Shopify Functions.

When you use the Bogus Gateway to test your store, you are essentially stress-testing these Functions. Because they execute during the checkout process, the test gateway allows you to see the logic in action without any delay. You can confirm that:

• Rules trigger instantly when cart attributes change.
• Renamed payment methods appear correctly in the UI.
• The checkout remains fast and responsive even with multiple active rules.

Testing these functions ensures that your customizations won't break during high-traffic events like Black Friday or a major product launch. For broader context on combining payment and shipping optimizations, check out the Nextools post introducing [HideSuite: the bundle for smart Shopify merchants](Introducing Nextools’ HideSuite: the bundle for smart Shopify merchants).

Finalizing Your Test Orders

After you have completed your simulations, your Shopify admin will contain several test orders. It is important to handle these correctly so they do not interfere with your actual business data.

Reviewing the Order Timeline

Open a test order in your Shopify admin. Look at the Timeline section to see the step-by-step history of the transaction. You should see a note indicating the order was processed using the Bogus Gateway or in Test Mode. This confirms that no real money was exchanged.

Canceling and Deleting Orders

To keep your analytics clean, you should cancel and delete test orders. While Shopify automatically excludes test transactions from most financial reports, deleting them prevents your fulfillment team from accidentally processing a fake order. To delete an order, you must first archive or cancel it. Once canceled, scroll to the bottom of the order page and select "Delete this order."

Reverting to Live Payments

The most critical step is deactivating the test environment. If you leave the Bogus Gateway active, real customers will not be able to pay for their orders.

1. Go to Settings > Payments.
2. Deactivate the Bogus Gateway.
3. Reactivate your actual payment provider (e.g., Shopify Payments or your third-party gateway).
4. Place one final "real" order (and refund it immediately) to ensure the connection is live.

Post-Testing Checklist:

• Cancel and delete all test orders from the admin.
• Disable "Test Mode" in Shopify Payments or deactivate the Bogus Gateway.
• Confirm that all your HidePay rules are toggled "On" and set to live mode.
• Verify that your shipping and tax settings were correctly applied during the test.

If you haven’t yet installed HidePay, you can [install HidePay](HidePay: Hide Payment Methods) and begin creating rules on a free-to-install plan.

Common Testing Scenarios for High-Volume Stores

For established merchants, testing goes beyond just checking if a button works. You need to ensure that your checkout can handle the complexities of a global customer base.

B2B and Wholesale Testing

If you offer B2B checkout options, use the test gateway to ensure that "Net 30" or "Bank Transfer" options only appear for customers with specific tags. A common mistake is allowing retail customers to see wholesale payment options, which can lead to confusion and manual order cancellations.

Currency Conversion Testing

If you sell in multiple currencies, simulate an order in a secondary currency like EUR or GBP. Verify that the payment gateway names and the sorting order remain consistent and that any currency-specific rules—such as hiding a local payment method for customers outside that region—are functioning properly.

Express Checkout Conflicts

Express buttons like Apple Pay or PayPal can sometimes bypass the standard checkout flow, ignoring your custom rules. Use the test environment to ensure that if you have set a rule to hide these buttons for certain products, they actually disappear. This protects your margins and ensures a consistent brand experience across all checkout paths. The HidePay documentation includes guidance for hiding dynamic checkout buttons where relevant; see the help docs index for tutorials on hiding PayPal Express and other dynamic buttons.

Protecting Your Bottom Line

The ultimate goal of testing with the Bogus Gateway is to protect your profitability. Every failed transaction is a lost opportunity, and every incorrectly displayed payment method is a potential risk.

By simulating failed transactions, you can audit your recovery emails. When a test order "fails" using card number 2, check if your store automatically sends an abandoned cart email and if that email includes a direct link back to the checkout. This workflow is essential for recovering revenue that would otherwise be lost.

Furthermore, testing helps you avoid high-fee scenarios. If you've configured our tool to hide expensive payment methods for low-margin items, the Bogus Gateway is your opportunity to verify that those high-cost options are successfully blocked. This proactive management of your checkout options ensures that you are always steering customers toward the most cost-effective and reliable payment paths.

For additional tips and case studies on checkout optimization and why payment/shipping control matters, visit Nextools’ main site to explore related articles and resources.

Summary of Key Takeaways

Testing your Shopify store is a straightforward process that yields significant rewards in reliability and customer satisfaction. By using the Bogus Gateway, you can simulate every possible checkout outcome without financial risk.

• Use the Bogus Gateway for a universal testing environment by entering "1" for success, "2" for failure, or "3" for errors.
• Leverage Shopify Payments Test Mode for more granular testing of specific card brands like Visa or Amex.
• Verify custom rules in our app to ensure that payment methods are hidden, sorted, and renamed according to your specific logic. See the HidePay documentation for help on sorting and renaming payment methods.
• Clean up your admin by canceling and deleting test orders to maintain accurate data and analytics.
• Reactivate live payments immediately after testing to ensure you are ready to accept real customer orders.

A well-tested checkout is the foundation of a successful e-commerce business. It gives you the confidence to scale, knowing that your infrastructure is optimized for both the customer experience and your bottom line.

If you are ready to take full control over your checkout, [get HidePay for your store](HidePay: Hide Payment Methods) and begin building and testing your payment rules today.

FAQ

Does the Bogus Gateway charge any transaction fees?

No, the Bogus Gateway is a simulation tool provided by Shopify and does not process real money. Because no actual transaction takes place with a bank or credit card provider, there are no processing fees or Shopify transaction fees applied to these orders.

Can I use my real credit card to test the Bogus Gateway?

No, real credit card numbers will not work while the Bogus Gateway is active. You must use the designated test numbers (1, 2, or 3) to trigger specific outcomes. If you want to test with a real card, you must use a live payment provider and then immediately refund the transaction.

Do test orders show up in my Shopify financial reports?

Shopify filters out orders made through the Bogus Gateway or in Test Mode from your primary financial analytics. However, they will still appear in your main "Orders" list. It is best practice to cancel and delete these orders to avoid any confusion during fulfillment.

Why can't I see the Bogus Gateway in my payment settings?

The Bogus Gateway is usually found under the "Third-party providers" section. If you currently have Shopify Payments active, you may need to click "Switch to a third-party provider" or "See all other providers" to find and select it from the list.

---