Introduction
Testing your checkout flow is a critical step before launching a new store or making major changes to your payment settings. The Shopify bogus payment gateway provides a safe, simulated environment to verify that your order processing, inventory updates, and customer notifications work exactly as intended. By using this tool, you can identify friction points in the customer journey without risking real capital or incurring transaction fees from third-party processors.
We developed HidePay on the Shopify App Store to help merchants take this control a step further by allowing them to hide, sort, and rename payment methods once their gateway is live. Before you can optimize which payment methods appear for which customers, you must first ensure that the underlying checkout logic is sound. This article serves as a technical walkthrough for merchants who need to master the Bogus Gateway to ensure a professional, error-free checkout experience.
You will learn how to activate the simulator, the specific credentials required for different testing outcomes, and how to transition back to a live environment once your testing is complete. Understanding these mechanics ensures that your store remains functional and reliable for every visitor.
What Is the Shopify Bogus Payment Gateway?
The Bogus Gateway is a built-in payment provider designed specifically for simulation. It mimics the behavior of a real credit card processor but does not actually process any funds or communicate with banking institutions. Any merchant on a paid Shopify plan can use this tool to create test orders that behave like real transactions in your admin panel.
It is important to distinguish the Bogus Gateway from the Shopify Payments Test Mode. While both allow for simulation, the Bogus Gateway is an independent provider. You use it by deactivating your real credit card provider and selecting "Bogus Gateway" from the list of third-party providers. This makes it a universal solution for merchants, regardless of whether they have access to Shopify Payments in their specific region.
When the gateway is active, it appears at checkout with a clear label indicating it is for testing purposes. This prevents real customers from accidentally attempting to use it if you happen to be testing on a live site—though we generally recommend testing during low-traffic periods or on a development store.
Why Simulated Testing Is Essential for Merchants
A checkout that fails at the final step is one of the fastest ways to lose customer trust. Simulated testing allows you to verify several distinct parts of your business operations that go beyond the simple "Pay" button.
Verifying Order Automations
Most modern Shopify stores rely on a stack of apps for marketing, fulfillment, and accounting. A test order placed through the Bogus Gateway triggers the same "Order Created" webhook as a real purchase. This allows you to verify that your email marketing tool sends the correct welcome sequence and that your shipping software receives the order details with the right line items and shipping rates.
Testing Inventory Logic
If you sell high-volume products or items with limited stock, you need to know that your inventory levels decrement correctly. Placing a test order confirms that your stock counts update in real-time. This is especially important if you use third-party inventory management systems that sync with Shopify.
Tax and Shipping Calculation
Configuring tax zones and shipping profiles can be complex, particularly for international merchants. By simulating a checkout for a specific province or country, you can see exactly how Shopify calculates the final total. You can verify that your VAT, GST, or local sales taxes are applying correctly to the cart before a real customer ever sees them.
Checkout Customization and Rules
If you use our app to hide or sort payment methods based on cart total or customer tags, the Bogus Gateway is the perfect tool to verify those rules. See our documentation on how to create a payment customization to learn how to define conditions like cart value, customer tags, and product rules and test them safely.
Hide, sort, and rename Shopify payment methods using powerful conditions. Customize your checkout and control payment options with HidePay.
How to Activate the Bogus Gateway
Activating the simulator requires a few specific steps in your Shopify admin. Because the Bogus Gateway acts as a primary payment provider, it cannot run simultaneously with another credit card processor.
- Navigate to Payments: In your Shopify admin, go to the Settings menu and select "Payments."
- Deactivate Existing Providers: If you already have a credit card provider like Shopify Payments or a third-party gateway active, you must deactivate it first. Click "Manage" and then "Deactivate." Don't worry; your settings are usually preserved for when you reactivate it later.
- Select the Gateway: Click on "See all other providers" or "Choose a provider" (depending on your region). Search for "(for testing) Bogus Gateway" and select it.
- Activate and Save: Click the "Activate" button and ensure you save your changes.
Once these steps are complete, your store is in a testing state. Any order placed from this point forward will be a test order and will not result in a real charge.
Essential Credentials for Bogus Gateway Testing
The Bogus Gateway does not accept real credit card numbers. Instead, it uses a simple "1, 2, 3" system to simulate the different outcomes a merchant might encounter during a live sale. When you reach the checkout page as a customer, use the following details:
The Successful Transaction (Number 1)
To simulate a successful payment where the order is marked as "Paid" and triggers all your post-purchase automations, enter "1" in the card number field. For the "Name on Card," use "Bogus Gateway." You can use any three-digit number for the CVV (like 111) and any date in the future for the expiry.
The Declined Transaction (Number 2)
It is just as important to see what happens when a payment fails. Enter "2" in the card number field to simulate a declined card. This allows you to see the error message the customer receives and ensures that your store does not fulfill an order or reduce inventory when a payment is unsuccessful.
The Gateway Failure (Number 3)
A gateway failure (entering "3" in the card number field) simulates a technical error between Shopify and the payment processor. This is a rare but critical scenario to test. It helps you understand the "Exceptions" that might occur if a provider's server goes down, allowing you to prepare support documentation or workflows for your customer service team.
Testing B2B and International Scenarios
For merchants running B2B operations or selling globally, the Bogus Gateway offers specific utility for complex setups.
B2B Company Testing
If you use Shopify's B2B features, testing requires a slightly different approach. You must ensure you have a test company profile and a company location set up. When you log in as a B2B customer and reach the checkout, the Bogus Gateway allows you to verify that the specific payment terms assigned to that company (such as Net 30) are interacting correctly with your standard credit card options.
Currency Requirements
One technical requirement of the Bogus Gateway is that the transaction must be greater than the equivalent of $1 USD. If you are testing in a different currency, such as JPY or EUR, ensure the cart total exceeds that $1 threshold. If the total is too low, the gateway may not trigger the simulation correctly, leading to confusion during the test.
Refining Your Checkout Strategy After Testing
Once you have used the Bogus Gateway to confirm that your checkout is technically functional, the next step is optimization. A functional checkout is the baseline, but an optimized checkout is what drives conversions.
We often see merchants struggle with "choice paralysis" at checkout. When a customer is presented with too many payment options—credit cards, digital wallets, buy-now-pay-later (BNPL), and manual methods—they may hesitate and abandon the cart. After your initial testing, consider the following strategies to improve the user experience.
Sorting for Preference
You can guide customers toward your preferred payment methods by reordering them. For example, if you prefer Shopify Payments over PayPal due to lower fees, you can move the credit card fields to the top. Using a tool like our app allows you to sort these methods dynamically; read more about HidePay features on the HidePay homepage.
Hiding Irrelevant Options
Not every payment method is appropriate for every order. If a customer is buying a digital gift card, you might want to hide "Cash on Delivery." If an order is over a certain amount, you might want to hide certain BNPL options to avoid high merchant fees. These rules, built on native Shopify Functions, ensure that the checkout remains clean and relevant to the specific transaction. For a practical example of hiding express methods, see the help guide on hiding the Express Checkout with HidePay.
Renaming for Clarity
Sometimes the default name of a payment gateway is confusing to customers. Localization is key for global stores. Renaming "Bank Deposit" to something more local, like "Wire Transfer" or "SEPA," can increase trust. Testing these labels while the Bogus Gateway is active allows you to see exactly how the text wraps and displays on mobile devices.
Moving from Simulation to Live Payments
Testing should never be a permanent state. Once you are satisfied with the order flow, inventory syncing, and notification triggers, you must return your store to a live state to accept real money.
- Deactivate Bogus Gateway: Go back to Settings > Payments. Click "Manage" next to the Bogus Gateway and select "Deactivate."
- Reactivate Your Real Gateway: Choose your primary provider (like Shopify Payments, Stripe, or Authorize.net) and follow the prompts to re-enable it.
- Verify Live Mode: Perform one final check. Many merchants choose to place a "Real Test Order." This involves using a real credit card to buy a low-priced item and then immediately refunding the transaction. While this may incur a small, non-refundable transaction fee from your bank, it is the only way to be 100% certain that the connection to the banking network is live and active.
When you’re ready to take optimization further, install HidePay and connect the same rules you tested with the Bogus Gateway to enforce the exact payment visibility you want on live orders.
Key Takeaways for Successful Testing
To get the most out of your simulated transactions, keep these practical points in mind:
- Check the Admin: Always look at the resulting order in your Shopify Admin. Ensure the payment status says "Paid" and the timeline shows the gateway interaction.
- Test on Mobile: Over 70% of e-commerce traffic often comes from mobile devices. Use the Bogus Gateway credentials on a smartphone to ensure the checkout UI is responsive and easy to navigate.
- Review Your Emails: Don't just check the Shopify admin; check your inbox. Verify that the "Order Confirmation" email looks professional and contains the correct details.
- Clear Your Cookies: If you find the checkout is still showing old payment methods after switching to the Bogus Gateway, try clearing your browser cache or opening the store in an Incognito/Private window.
For additional reading on optimizing checkout and combining payments with shipping rules, check our article introducing the HideSuite bundle for merchants which explains how HidePay and HideShip work together to reduce friction and cut costs.
By following this structured approach to testing, you eliminate the guesswork from your store's most important page. The Bogus Gateway is a powerful, free resource that every merchant should use whenever they introduce new logic, new apps, or new payment rules to their checkout.
Once your gateway is confirmed to be working perfectly, you can begin the process of fine-tuning the experience. Whether that involves sorting your best-performing methods to the top or hiding high-fee options for specific regions, the goal is always a frictionless path to purchase. Using HidePay, you can implement these advanced rules natively within Shopify, ensuring that your optimized checkout remains fast and reliable for every customer.
FAQ
Does the Shopify Bogus Payment Gateway cost money to use?
No, the Bogus Gateway is a free tool provided by Shopify for testing purposes. It does not process real transactions, so you will not be charged any subscription fees, transaction fees, or credit card processing fees for any test orders placed while it is active.
Can I use the Bogus Gateway while Shopify Payments is active?
No, you cannot have both active at the same time. To use the Bogus Gateway, you must first deactivate your current credit card provider, including Shopify Payments. Once your testing is complete, you can deactivate the Bogus Gateway and re-enable your real payment provider.
Why does my test order show as "Paid" if no money was exchanged?
The purpose of the Bogus Gateway is to simulate a successful transaction. When you use the test card number "1," Shopify treats the order as fully paid so you can see how your store handles a completed sale, including inventory updates and customer notification emails.
What should I do if the Bogus Gateway isn't appearing in my list of providers?
If you are in a country where Shopify Payments is available, you may need to click "See all other providers" within the Shopify Payments section to find it. If you are in a region without Shopify Payments, it should appear under the general "Payment Providers" or "Choose a provider" menu. Ensure you are on a paid Shopify plan, as simulated gateways are generally not available on completely free trial periods without a selected plan.
For step‑by‑step setup or to troubleshoot custom rules, consult the full HidePay help documentation which includes guides on currency-based rules, cart-total conditions, and hiding express checkout buttons.