Indietro Guide ai pagamenti

Using a Shopify Bogus Gateway Credit Card Number to Test Checkout

Learn how to use a Shopify bogus gateway credit card number to test your checkout. Follow our guide to simulate successful, declined, and failed transactions.

Introduction

Testing your checkout flow is a critical step before launching a new store or updating your payment rules. Using a Shopify bogus gateway credit card number allows you to simulate transactions without using real money or affecting your financial analytics. This ensures your customer journey remains frictionless from the first click to the order confirmation page.

We built HidePay to help merchants control which payment methods appear at checkout, but even the most precise rules require validation. Understanding how to use simulated credentials helps you verify that your checkout logic works exactly as intended. Whether you are testing geography-based restrictions or currency-specific options, the Bogus Gateway is your primary tool for quality assurance — if you want to start testing today, get HidePay for your store.

This guide explains how to set up the Bogus Gateway, provides the specific card numbers you need to simulate various outcomes, and details how to test advanced checkout configurations. You will learn how to verify your setup so you can go live with total confidence.

What is the Shopify Bogus Gateway?

The Bogus Gateway is a built-in payment provider designed specifically for testing. It allows any merchant to place orders and see the resulting order processing flow without a real credit card being charged. This is different from "Test Mode" on a real provider, as it completely replaces your active payment processor with a simulated environment.

When you use this tool, you are not communicating with a bank or a third-party processor. Instead, Shopify handles the request internally. This is why you must use specific digits rather than standard card numbers. It is an essential utility for developers and store owners who need to see how taxes, shipping rates, and email notifications behave when an order is successfully placed or declined.

Using this gateway is safer than placing real orders and refunding them. Real transactions often involve non-refundable processing fees from your bank or gateway. The Bogus Gateway avoids these costs entirely while providing the same visual and functional experience for the merchant and the end user.

The Shopify Bogus Gateway Credit Card Number List

To test different scenarios, you must enter specific numbers in the credit card field during checkout. The system recognizes these single-digit entries as commands to trigger a specific result.

Simulate a Successful Transaction

To confirm that your checkout process works and that customers can complete an order, use the following details:

  • Credit card number: 1
  • Name on card: Bogus Gateway
  • CVV: Any three-digit number (e.g., 111)
  • Expiry Date: Any date in the future

When you enter "1," the system treats the transaction as approved. You will be redirected to the "Thank You" page, and Shopify will generate a new order in your admin panel marked as paid.

Simulate a Declined Transaction

It is just as important to know what happens when a payment fails. You need to ensure your store displays a clear error message to the customer.

  • Credit card number: 2
  • Name on card: Bogus Gateway
  • CVV: Any three-digit number
  • Expiry Date: Any date in the future

Entering "2" triggers a declined message. This allows you to verify that the customer stays on the checkout page and receives instructions to try a different payment method.

Simulate a Gateway Failure

A gateway failure is different from a simple decline. It suggests a technical issue between the store and the processor.

  • Credit card number: 3
  • Name on card: Bogus Gateway
  • CVV: Any three-digit number
  • Expiry Date: Any date in the future

Entering "3" simulates an exception. This is useful for testing how your store handles unexpected downtime from a payment provider and ensuring your support links or fallback messages are visible.

Personalizza facilmente Shopify Payments

Nascondi, ordina e rinomina i metodi di pagamento di Shopify usando potenti condizioni. Personalizza il tuo checkout e controlla le opzioni di pagamento con HidePay.

How to Activate the Bogus Gateway in Your Store

Activating the Bogus Gateway requires a few specific steps in your Shopify admin. Because you can only have one primary credit card provider active at a time, you must temporarily swap your live provider for the testing tool.

  1. Log in to your Shopify admin and navigate to Settings > Payments.
  2. Locate your current credit card provider. If you use Shopify Payments, click Manage, scroll to the bottom, and select Switch to a third-party provider. Confirm the switch.
  3. If you use a third-party provider like Stripe or Authorize.net, click Manage and then Deactivate.
  4. Once your active provider is removed, look for the Payment providers section and click Choose a provider.
  5. Search for (for testing) Bogus Gateway in the list.
  6. Select it and click Activate (for testing) Bogus Gateway.

After you click save, the Bogus Gateway is live. Every order placed on your store from this moment until you deactivate it will be a test order. It is important to note that you should not do this on a live store with active traffic unless you are prepared for real customers to see the Bogus Gateway option.

Testing with Shopify Payments Test Mode

If you do not want to deactivate Shopify Payments to use the Bogus Gateway, you can use the built-in Test Mode. This is often more convenient for stores already using Shopify's native processor. Unlike the Bogus Gateway, Test Mode requires full 16-digit card numbers to simulate transactions.

To enable this, go to Settings > Payments, click Manage on the Shopify Payments section, and check the box for Enable test mode.

Test Card Numbers for Shopify Payments

When Test Mode is active, use these card numbers to simulate successful payments:

  • Visa: 4242 4242 4242 4242
  • Mastercard: 5555 5555 5555 4444
  • American Express: 3782 822463 10005
  • Discover: 6011 1111 1111 1117

For failed transactions in Test Mode, you can use specific numbers to trigger different error types:

  • Card Declined: 4000 0000 0000 0002
  • Insufficient Funds: 4000 0000 0000 9995
  • Incorrect CVC: 4000 0000 0000 0127
  • Expired Card: 4000 0000 0000 0069

This method provides a more granular look at how different card types and failure reasons appear in your order timeline.

Why Testing Your Checkout Logic Matters

Modern e-commerce requires more than just a "Buy" button. Many merchants use complex rules to protect their margins and improve the user experience. For example, you might want to hide high-fee payment methods for low-value orders or restrict certain gateways to specific countries.

HidePay is designed to help with those exact problems — to learn more about the app and the problems it solves, see Introducing HidePay on the Nextools blog.

Consider a merchant who sells globally but wants to avoid Cash on Delivery (COD) for international orders. By setting a rule to hide COD when the shipping address is outside the home country, the merchant protects their logistics. By then using the Bogus Gateway, they can enter various addresses at checkout to confirm that the COD option appears only when it should.

Action Summary: Preparing for a Test

  • Deactivate your live payment provider to enable the Bogus Gateway.
  • Keep a list of the test numbers (1, 2, and 3) ready.
  • Open your storefront in an incognito window to see the checkout as a customer.
  • Clear your browser cache if the changes do not appear immediately.

Validating Rule-Based Checkout Customizations

Once your testing environment is active, you can begin validating the logic of your checkout. Most merchants find that a "one-size-fits-all" checkout leads to higher fees or unnecessary chargebacks. Customizing which methods appear based on cart attributes is a smart strategy for growth.

If you have implemented rules to sort your payment methods, the Bogus Gateway helps you verify the visual hierarchy. For details on reordering and renaming, consult the Sort and Rename payment methods documentation.

For instance, you may want to push digital wallets like Apple Pay or Google Pay to the top to increase mobile conversion rates. Placing a test order allows you to see the exact order of these methods on a mobile device.

We designed our app to handle these adjustments through Native Shopify Functions. This means the rules are executed directly on Shopify's infrastructure, ensuring high performance. When you test your rules with simulated card numbers, you are seeing exactly how the Shopify engine processes your custom logic.

To create native checkout functions without coding, you can explore SupaEasy for codeless Shopify Functions.

Testing Geographically-Based Rules

Geography is one of the most common reasons to hide or rename a payment method. Some providers are only available in specific regions, while others may have higher processing fees in certain provinces or countries.

When the Bogus Gateway is active, you can test these rules by changing the shipping address during the checkout process.

  1. Enter an address in a region where you want a specific payment method to be hidden.
  2. Verify that the method does not appear in the payment list.
  3. Change the address to a region where the method is allowed.
  4. Confirm the method reappears instantly.

If you want step-by-step guidance for creating country- or market-based rules, see how to create a payment customization in the HidePay docs.

This level of testing prevents situations where a customer in a restricted region accidentally selects a payment method that you cannot fulfill. It also helps you verify that your renaming rules (such as changing "Bank Transfer" to a local equivalent) are appearing correctly for the right audience.

Testing for High-Ticket and B2B Orders

B2B and high-ticket merchants often face higher risks at checkout. Accepting a credit card for a $10,000 order might result in significant processing fees or a devastating chargeback. Many of these merchants prefer to hide credit card options for large orders and instead surface "Wire Transfer" or "Invoice" options.

You can test this by adding high-value items to your cart while the Bogus Gateway is active.

  • Check if the credit card field disappears when the cart total exceeds a certain threshold.
  • Verify that your preferred B2B payment methods become visible.
  • Complete the order with a test number to ensure the "Invoice" instructions appear correctly on the order confirmation page.

For guidance on hiding methods based on thresholds, see how to create a payment customization to hide payment methods by cart total.

This process ensures that your high-value transactions are directed toward the most secure and cost-effective payment channels.

Handling Order Notifications and Inventory

A successful test order does more than just verify the checkout page. It triggers a sequence of events in your Shopify admin that you should also review. When you use the "1" card number to complete a Bogus Gateway transaction, Shopify treats the order as "Paid."

Take this opportunity to check:

  1. Order Confirmation Email: Does the email look professional? Does it include the correct billing and shipping details?
  2. Inventory Levels: Did the products in the test order get deducted from your inventory?
  3. Staff Notifications: Did your team receive the notification to fulfill the order?
  4. Order Timeline: Check the timeline in the Shopify admin to see exactly how the Bogus Gateway recorded the transaction.

If you find that emails are not sending or inventory is not updating as expected, reach out to Nextools support for help.

Transitioning Back to Production

Once you have verified that your checkout flow, payment rules, and post-purchase notifications are working perfectly, you must return your store to production mode.

  1. Navigate back to Settings > Payments.
  2. Click Manage next to the Bogus Gateway.
  3. Select Deactivate (for testing) Bogus Gateway.
  4. Re-activate your primary payment provider. If you are using Shopify Payments, you may need to click Choose a provider or Manage to re-enable it.
  5. Ensure Test Mode is turned off on your live provider settings.

Always place one final "real" order using a personal credit card after going back to production. You can refund this order immediately. This final check confirms that the connection between Shopify and your actual payment processor is active and secure.

If you want to re-install the app or verify settings after switching back, install HidePay from the Shopify App Store.

The Role of Shopify Functions in Checkout Control

The way merchants customize their checkout has changed significantly. In the past, these changes required complex scripts that were often slow or difficult to maintain. Today, we utilize Native Shopify Functions to provide these capabilities.

Because HidePay is built on this native architecture, it doesn't rely on theme code edits or external workarounds. This makes your checkout more stable and significantly faster. When you use a Shopify bogus gateway credit card number to test your store, you are interacting with a checkout that is optimized for performance and security.

To learn more about validations and advanced checkout logic, read the Cart & Checkout Validation API guide on the Nextools blog.

Using native tools also ensures that your checkout remains compatible with Shopify's frequent updates. As the platform evolves, your payment rules and sorting logic will continue to function without requiring constant manual fixes.

Action Summary: Post-Testing Checklist

  • Archive or cancel all test orders to keep your admin clean.
  • Verify that your inventory counts have been restored if necessary.
  • Double-check that the "Test Mode" banner is no longer visible on your storefront.
  • Ensure your live payment provider is receiving transactions by placing a real small-value order.

Summary of Checkout Optimization

A clean, logical checkout is the foundation of a successful Shopify store. By removing irrelevant payment options and surfacing the ones most likely to convert, you reduce friction for your customers and protect your business from unnecessary fees.

Testing with the Bogus Gateway is the most effective way to validate your strategy. It allows you to explore every possible customer scenario without financial risk. Once you are confident that your rules are working, you can focus on scaling your traffic and growing your sales.

For a broader toolkit that combines payment and shipping controls, see Introducing Nextools’ HideSuite on the Nextools blog.

Our app, HidePay, provides the tools you need to implement these professional checkout strategies. From hiding methods by geography to sorting them by customer tag, we give you complete control over the most important page in your store.

If you are ready to take full control of your checkout experience, HidePay — free to install on the Shopify App Store. We offer a free plan to get you started, and our "Built for Shopify" certification ensures you are using a reliable, high-performance solution. Visit the Shopify App Store to view current pricing and start optimizing your checkout today.

FAQ

Can I use the Bogus Gateway on a live Shopify store?

Yes, you can activate it on a live store, but it is not recommended if you have active traffic. When enabled, the Bogus Gateway replaces your real payment provider. This means real customers will see the "Bogus Gateway" option and will not be able to pay with their actual credit cards until you switch back to your real processor.

Do Bogus Gateway test orders show up in my financial reports?

No, Shopify excludes test orders and simulated transactions from your payouts and financial reports. This ensures that your actual sales data remains accurate. However, the orders will appear in your "Orders" list, so you should archive or delete them after testing to keep your admin interface organized.

What happens if I use a real credit card number while the Bogus Gateway is active?

The transaction will not work. The Bogus Gateway is specifically programmed to look for the test numbers (1, 2, or 3). If you enter a real 16-digit credit card number, the gateway will return an error or a decline because it does not recognize the format as a valid test command.

Why don't I see the Bogus Gateway in my list of payment providers?

If you have Shopify Payments currently active, the Bogus Gateway may be hidden. You typically need to click "Manage" on Shopify Payments and select "Switch to a third-party provider" first. Once Shopify Payments is deactivated, the Bogus Gateway will appear in the list of available providers under the "Third-party providers" or "Other" sections.

Inizia a usare HidePay

Nascondi, ordina e ottimizza i metodi di pagamento di Shopify istantaneamente, senza bisogno di codice.