Introduction
Testing your checkout flow is a mandatory step for any merchant before going live or after making significant structural changes to a store. It ensures that payment gateways, shipping calculations, and order notifications function exactly as intended. By using a test credit card on Shopify, you can simulate various transaction outcomes without spending a single cent or impacting your financial reports.
We developed HidePay to give you precise control over which payment methods appear during this process, allowing you to refine the customer experience further. Whether you are troubleshooting a failed transaction or verifying a new rule-based payment restriction, a simulated order provides the necessary data without the risk of real-world processing fees. If you’re ready to try it in your store, you can get HidePay for your store. This article explains how to use the Bogus Gateway and Shopify Payments test mode to verify your store's performance.
Why You Must Test Your Shopify Checkout
A functioning checkout is the difference between a completed sale and a lost customer. Merchants often assume that once a gateway is connected, it will work perfectly across all devices, currencies, and customer locations. However, complex configurations—such as custom discount logic or specific shipping rules—can occasionally create conflicts at the final step.
Simulating orders allows you to verify that your inventory levels update correctly after a purchase. It also lets you see the exact email notifications your customers receive. If you are using rules to hide or sort payment methods based on cart attributes, testing ensures those conditions trigger correctly. Running a simulation is the only way to confirm that your logic holds up under real-world conditions before a customer reaches the payment field.
Using the Shopify Bogus Gateway
The Bogus Gateway is a simplified payment provider built specifically for testing. It is available to every Shopify store and does not require an active payment plan to function. This method is ideal for checking the general flow of your checkout when you do not want to interfere with your actual payment provider settings.
How to Activate the Bogus Gateway
To use this gateway, you must temporarily disable your primary credit card provider. Navigate to the payment settings in your Shopify admin. If you have a provider like Shopify Payments or a third-party gateway active, deactivate it.
Once deactivated, search for the "Bogus Gateway" in the list of available providers. Activate it and save your settings. Every order placed while this gateway is active will be treated as a test order. These transactions do not appear in your financial payouts and do not incur processing fees.
Test Credentials for Bogus Gateway
When you reach the checkout page of your store, you will need specific credentials to simulate different outcomes. Use "Bogus Gateway" as the name on the card. For the expiry date, use any date in the future, and for the CVV, any three-digit number will work. Use the following card numbers to test specific scenarios:
- Enter 1: Simulates a successful, approved transaction.
- Enter 2: Simulates a declined transaction to see the error message.
- Enter 3: Simulates a gateway failure or technical exception.
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.
Testing with Shopify Payments Test Mode
If you use Shopify Payments as your primary gateway, you should use its built-in test mode rather than the Bogus Gateway. This allows you to test specific card types—like Visa, Mastercard, or American Express—and see how they are handled by the native Shopify infrastructure.
Enabling Test Mode
In your Shopify admin, locate the Shopify Payments section and select the management option. Scroll down to the test mode section and toggle the checkbox to enable it. Remember to save your changes. While this mode is active, your store cannot accept real payments from customers. We recommend performing these tests during low-traffic periods or on a development store.
Successful Transaction Card Numbers
To simulate a successful purchase in Shopify Payments test mode, use at least two words for the card name and any future expiry date. Use the following numbers based on the card type you wish to test:
| Card Type | Test Card Number |
|---|---|
| Visa | 4242 4242 4242 4242 |
| Mastercard | 5555 5555 5555 4444 |
| American Express | 3782 822463 10005 |
| Discover | 6011 1111 1111 1117 |
| JCB | 3530 1113 3330 0000 |
| Diners Club | 3056 9309 0259 04 |
Simulating Transaction Failures
Testing how your store handles failure is just as important as testing success. It helps you verify that the error messages shown to customers are clear and helpful. Use these specific card numbers in test mode to trigger various errors:
- Generic Decline: 4000 0000 0000 0002
- Insufficient Funds: 4000 0000 0000 9995
- Incorrect Card Number: 4242 4242 4242 4241
- Expired Card: 4000 0000 0000 0069
- Processing Error: 4000 0000 0000 0119
Testing Rules and Payment Customizations
Standard testing focuses on whether the card is accepted. Advanced testing focuses on whether the right payment options appear for the right customer. If you use our tool to hide payment methods for high-risk orders or specific geographic regions, a standard test order helps you confirm these rules are active.
For example, if you have a rule in HidePay that hides Cash on Delivery for orders over $200, you should place a test order with a $250 cart total. Use the test credit card numbers to complete the checkout and ensure the COD option was successfully hidden. If you are also using HideShip to manage shipping methods, you can simultaneously verify that your shipping and payment rules do not conflict.
If you need a step-by-step walkthrough for creating payment rules, see our guide on how to create a payment customization. To learn how to sort or rename methods used in those rules, read the guide on sorting and renaming payment methods. If you need to hide payment options based on cart attributes specifically, this article shows how to hide payment methods using cart attributes.
Verifying Geographic and Currency Rules
If you sell internationally, your checkout logic likely changes based on the customer’s location. You can test this by using a VPN or by entering an international address during the shipping step of your test order. This allows you to verify that:
- Local payment methods (like iDEAL in the Netherlands or Klarna in Germany) appear correctly.
- The currency displayed matches the customer's region.
- Any sorting rules you have set up prioritize the most relevant payment options for that market.
For multi-market workflows and examples of combining payment and shipping customization, see our article introducing HideSuite, which explains why merchants use both payment and shipping rules together.
Testing Third-Party Payment Providers
Third-party gateways such as PayPal, Stripe, or Braintree often have their own sandbox environments. Testing these requires a slightly different approach than the native Shopify tools. You will usually need to create a developer account with the provider to obtain sandbox API keys.
Once the sandbox mode is active in the provider's own dashboard, Shopify will recognize that the gateway is in test mode. You can then use the provider’s specific test card numbers. If a third-party provider does not offer a native test mode within the Shopify admin, you may need to use the "real transaction" method.
The Real Transaction Method
If you cannot use a test mode, you can place a real order using your own personal credit card. To minimize the impact, set the price of a test product to a small amount, like $1.00. Complete the purchase as a customer would, then immediately cancel and refund the order in your Shopify admin.
Be aware that most payment processors do not refund the credit card processing fee when you issue a refund. While this is the most accurate way to test a live gateway, it will cost you a small amount in non-refundable fees.
Best Practices for a Smooth Testing Process
- Test on multiple devices: A checkout that works on a desktop may have layout issues on a mobile device. Always run at least one test order on a smartphone.
- Check your automated emails: After placing a test order, check your inbox. Ensure the order confirmation email looks professional and includes the correct tax and shipping details.
- Isolate your variables: If you are testing new payment rules, turn off other apps or scripts that might interfere with the checkout. This helps you identify the exact cause if a rule fails to trigger.
- Verify inventory updates: Check the product page after your test order to ensure the stock level has decreased by the correct amount.
- Turn off test mode immediately: It is easy to forget that test mode is active. Once you have finished your verification, go back to your payment settings and ensure real transactions are enabled.
Using Shopify Functions for Better Testing
HidePay is built on Native Shopify Functions, which is the modern standard for checkout customization. Unlike the older Script Editor, Shopify Functions run natively on Shopify's infrastructure. This means when you are testing credit cards, the performance you see in test mode is an accurate reflection of how the app will perform in a live environment. There are no scripts to slow down the page load or cause intermittent failures.
If you are using other tools from Nextools, such as CartBlock for order validation or SupaEasy for custom discounts, testing becomes even more important. You need to ensure that a customer who is "blocked" from using a certain payment method is given a clear reason or offered an alternative that helps them complete the sale. For more background on how HidePay fits into our product suite, see the HidePay announcement on our blog.
Action Summary: Your Testing Checklist
- Select your method: Use Bogus Gateway for general flow or Shopify Payments Test Mode for specific card type verification.
- Enable the mode: Toggle the test mode in your payment settings.
- Place the order: Add items to your cart and use the designated test card numbers (e.g., 4242... for Visa).
- Verify the logic: Check that your payment sorting and hiding rules triggered as expected.
- Audit the results: Confirm the order appears in your admin, inventory is updated, and emails were sent.
- Go live: Deactivate test mode and perform one final check of your payment settings.
Cleaning Up Test Data
Test orders remain in your Shopify admin to provide a historical record of your testing activity. While you cannot permanently delete an order that has been processed through a gateway, you can archive it. Archiving the order removes it from your open orders list and prevents it from cluttering your daily fulfillment workflow.
To archive a test order, open the order details in your admin, click the "More Actions" menu, and select "Archive." This keeps your dashboard clean while preserving the data for future reference. Note that test orders are automatically excluded from your Shopify Analytics reports, so they will not skew your conversion rate or total sales data.
Conclusion
Successfully placing a test order is a foundational skill for Shopify merchants. It allows you to verify that your technical setup supports your business goals. By using test credit cards, you can confirm that your payment gateways are active, your notifications are accurate, and your inventory is syncing correctly.
When you use HidePay to manage your checkout, testing becomes a tool for optimization rather than just a technical hurdle. You can confidently hide high-fee payment methods or prioritize the ones that offer the best conversion rates for your specific audience. To start optimizing your checkout today, you can install HidePay — free to install on the Shopify App Store. For the latest updates and related resources, check our blog and the Nextools blog index.
FAQ
Does using a test credit card on Shopify cost any money?
No, transactions made through the Bogus Gateway or Shopify Payments test mode do not process real funds and incur no transaction fees. If you choose to test using a real credit card and then refund the order, you may be responsible for the non-refundable processing fees charged by your gateway.
Why is my test credit card being declined in Shopify Payments test mode?
Ensure you have "Enable test mode" checked in your Shopify Payments settings. If test mode is not active, the system will attempt to process the test number as a real card, which will result in a failure. Also, verify that you are using the exact test numbers provided by Shopify, such as 4242 4242 4242 4242 for Visa.
Will test orders show up in my sales reports?
Shopify automatically filters out test orders and simulated transactions from your financial reports and analytics. This ensures your data remains accurate and reflects only genuine customer purchases. You can identify these orders in your admin by the "Test" label or the specific gateway used.
Can I test Shop Pay or PayPal using Shopify's test mode?
Shopify Payments test mode does not support testing for Shop Pay, PayPal, or other express checkout buttons. To test these, you generally need to use the sandbox environment provided by the specific service or perform a real transaction with a manual refund afterward.
Resources and further reading
- How to create a payment customization (help doc)
- Sort and Rename payment methods in the Checkout (help doc)
- How to Hide Payment Methods Using Cart Attributes in HidePay (help doc)
- Introducing HidePay for Shopify — say goodbye to irrelevant payment options (blog)
- Introducing Nextools’ HideSuite: the bundle for smart Shopify merchants (blog)
- Nextools Blog index (blog)
- Get HidePay for your store (Shopify App Store)
- Install HidePay (Shopify App Store)