How to Use Shopify Payment Gateway Test Mode Successfully

Introduction

Testing your checkout process is a fundamental step in ensuring a reliable customer experience. When you verify that your payment settings, shipping rules, and tax calculations work as intended, you prevent abandoned carts and technical errors. Using a Shopify payment gateway test mode allows you to simulate the entire buying journey without processing real financial transactions.

By integrating HidePay into your workflow, you can further refine how these payment options appear to your customers once your store goes live. If you want to get started quickly, you can [install HidePay from the Shopify App Store](HidePay — free to install). This guide explains how to use both the Shopify Payments test mode and the Bogus Gateway to validate your store configuration. We will cover the specific test credentials required for different scenarios and how to transition from testing to a live environment.

Understanding these testing tools ensures that your store handles every transaction correctly, from successful authorizations to declined cards. This practical walkthrough provides the steps needed to secure your checkout's performance.

Setting Up Shopify Payments Test Mode

Shopify Payments includes a built-in test mode that lets you simulate transactions using specific test card numbers. This feature is essential for checking how orders are created and how your fulfillment workflow handles new incoming sales. You must be on a paid Shopify plan to use this feature.

To activate this mode, follow these steps in your Shopify admin:

1. Navigate to Settings and select Payments.
2. Find the Shopify Payments section and click Manage.
3. Scroll to the Test Mode section.
4. Check the box for "Enable test mode."
5. Click Save to apply the changes.

While this mode is active, you cannot use real credit cards for purchases. If you attempt to use a real card, the system will return an error. This prevents accidental charges during the development or optimization phase. It is also important to note that some local payment methods, such as iDEAL or Sofort, are often hidden when test mode is active because they require real-time external authentication.

Next Steps for Setup

• Confirm that a "Test Mode" banner appears on your online store checkout.
• Ensure you are not in a production environment with active customers while this is enabled.
• Prepare your list of test card numbers for the next phase of validation.

If you plan to control which payment methods appear after testing, see the HidePay guide on [how to create a payment customization] for step-by-step rule creation.

Simulating Successful Transactions

After enabling test mode, you can place orders as a customer would. To simulate a successful payment, you must use specific card numbers provided by Shopify. These numbers tell the system to approve the transaction immediately.

When prompted for payment details at checkout, use the following information:

• Name on card: Enter at least two words (e.g., "Test Customer").
• Expiry date: Use any date in the future (e.g., 12/30).
• Security code: Use any three digits (or four for American Express).

Use these specific card numbers to test different card types:

Card Type	Test Card Number
Visa	4242 4242 4242 4242
Mastercard	5555 5555 5555 4444
American Express	3782 8224 6310 005
Discover	6011 1111 1111 1117
Diners Club	3056 9309 0259 04
JCB	3566 0020 2036 0505

When you complete the order with these details, Shopify generates a successful order record. You can then view this order in your admin to verify that the payment status is "Paid" and that all shipping and tax logic applied correctly.

Testing Failed Transactions and Errors

A robust checkout must handle failures as gracefully as successes. Testing declined cards allows you to see exactly what your customers experience when their payment fails. This helps you confirm that error messages are clear and that the customer is prompted to try another payment method.

To simulate a failure, use the following card numbers in the Shopify Payments test mode:

• Generic Decline: 4000 0000 0000 0002
• Insufficient Funds: 4000 0000 0000 9995
• Expired Card: 4000 0000 0000 0069
• Incorrect CVC: 4000 0000 0000 0127
• Incorrect Number: 4242 4242 4242 4241

You can also test more complex scenarios like a disputed transaction (chargeback) by using the number 4000 0000 0000 0259. Simulating these errors ensures that your backend systems, such as inventory management or automated customer emails, do not trigger incorrectly for failed attempts.

Using the Shopify Bogus Gateway

The Bogus Gateway is an alternative testing tool. It is particularly useful if Shopify Payments is not available in your region or if you want to test the checkout without affecting your Shopify Payments configuration. The Bogus Gateway acts as a simulated third-party provider.

How to Activate the Bogus Gateway

To use the Bogus Gateway, you must first deactivate any active credit card providers.

1. Go to Settings > Payments in your Shopify admin.
2. If Shopify Payments is active, click Manage, then scroll to the bottom and click "Switch to a third-party provider."
3. If a third-party provider is active, click Manage and then Deactivate.
4. Once other providers are off, look for the "Payment providers" section.
5. Click "Choose a provider" or "See all other providers."
6. Search for and select "(for testing) Bogus Gateway."
7. Click Activate.

The Bogus Gateway is now live on your checkout. Remember that while this is active, your store cannot accept real payments. This method is best suited for development stores or maintenance windows.

Bogus Gateway Test Credentials

The Bogus Gateway uses a simplified set of credentials compared to Shopify Payments. Use the following details at checkout:

• Card Name: Bogus Gateway
• Expiry Date: Any future date
• CVV: Any 3-digit number
• Card Number:
  • Enter 1 for a successful transaction.
  • Enter 2 for a declined transaction.
  • Enter 3 for a gateway error (exception).

This simple 1-2-3 system makes it very fast to run through multiple testing cycles.

Testing Shop Pay and Express Checkouts

Express checkout buttons like Shop Pay, Apple Pay, and Google Pay often behave differently than standard credit card fields. Testing these is vital because they often pull customer data directly from the user's digital wallet, which can sometimes bypass or conflict with your store's shipping or discount rules.

To test Shop Pay, you can use the Shopify Payments test mode. When adding a card to your Shop Pay account for testing, enter test_card at the beginning of the "Nickname" field. This tells Shop Pay to treat the card as a test instrument. You can then use the standard Shopify Payments test numbers.

For Apple Pay and Google Pay, these services often use real cards even in test mode. If you see a successful transaction in your store admin with a "Test Mode" banner, the charge was not actually processed. Always verify the presence of that banner before assuming the test worked correctly.

If you need to hide or disable express checkout buttons as part of your optimization, see the HidePay documentation on [sort and rename payment methods in the checkout] for guidance on ordering and visibility.

Testing B2B and International Checkouts

B2B (Business to Business) checkouts involve unique variables like company locations, tax exemptions, and specific payment terms (e.g., Net 30). To test these, you must first create a test company and a test customer assigned to that company in your Shopify admin.

When testing international checkouts, you should verify how different currencies are handled. Shopify Payments test mode supports multi-currency testing. Place an order using a different currency selector on your storefront and use the standard test card numbers. Check the order details to ensure the conversion rates and localized taxes appear correctly.

For international merchants, we often see a need to restrict certain payment methods based on the customer's location. For example, you might want to offer Cash on Delivery (COD) only to local customers while hiding it for international orders. This is where advanced control becomes necessary; consult the HidePay article on [how to hide payment methods for specific products or conditions] to learn how to target geography and other rule types.

Optimizing the Checkout After Testing

Once you have verified that your payment gateways are functioning, the next step is to optimize the checkout for conversions. A cluttered checkout with too many payment options can lead to analysis paralysis, causing customers to abandon their carts.

We developed HidePay to give merchants the tools to manage this complexity. Instead of showing every possible payment method to every customer, you can use our app to curate the experience. To add HidePay to your store and begin customizing payment visibility, [get HidePay for your store] from the Shopify App Store.

Sorting for Better Conversions

Order matters. If you know that your customers prefer Shop Pay or credit cards over other methods, you should place those at the top. Sorting your payment methods allows you to guide the customer toward the fastest and most reliable options.

For details on handling payment methods that share the same name (for example, multiple entries produced by Shopify Payments), refer to the HidePay help page about [sorting payment methods with the same name].

Hiding High-Risk Options

Some payment methods carry higher risks of chargebacks or higher processing fees. With the app, you can hide specific gateways if a cart total exceeds a certain amount or if the customer has a specific tag. This protects your margins without hurting the user experience for low-risk orders; the HidePay article on [creating payment customizations] explains how to set these conditions.

Renaming for Clarity

Sometimes the default name of a payment gateway is confusing to customers. You can use the tool to rename "Shopify Payments" to "Credit / Debit Card" or "Alternative Payments" to something more descriptive. This small change improves trust and reduces friction. See the HidePay guide on [sort and rename payment methods in the checkout] for instructions.

The app runs on native Shopify Functions. This means the rules you set are processed directly within Shopify's infrastructure. There are no external scripts slowing down your checkout, ensuring that your optimizations do not come at the cost of performance.

If you use shipping rules or need to coordinate payment visibility with shipping options, Nextools also publishes a post introducing the [HideSuite bundle], which pairs HidePay with HideShip to manage both payments and shipping together.

Troubleshooting Test Mode Issues

Even with a clear process, you might encounter issues while testing your payment gateway.

Order Confirmation Emails Not Received If you are not receiving emails for test orders, check your notification settings. Ensure the "Order Confirmation" template is active. If you have customized the template, try reverting it to the default version to see if a coding error is preventing the send.

Local Payment Methods Missing If you are looking for iDEAL, Bancontact, or similar local methods, they will not appear while Shopify Payments is in test mode. To test the flow for these, you may need to use a real transaction and then immediately refund it.

Test Mode Banner Not Appearing If you don't see the "Test Mode" banner on an order, you likely processed a real transaction. Immediately check your payment provider's dashboard and issue a refund to avoid fees. Always double-check that the "Enable test mode" box is checked and saved in your settings.

B2B Test Orders Failing B2B orders require the customer to be logged in and associated with a company. If the payment fails or doesn't show the correct terms, verify that the customer's company location has the correct payment terms assigned in the Shopify admin.

If a rule you created with HidePay is not working as expected, consult the help doc on [how to debug a rule customization] for steps to enable debug mode and share logs with support.

Conclusion

Successfully using the Shopify payment gateway test mode is the best way to ensure your store is ready for real customers. By alternating between Shopify Payments test mode and the Bogus Gateway, you can validate every possible checkout scenario, from successful high-value orders to common credit card errors.

Testing is not a one-time task; you should perform these checks whenever you update your shipping rates, add new apps, or change your tax settings. Once your gateway logic is sound, you can focus on refining the customer experience. HidePay helps you take this a step further by giving you total control over which payment methods appear, how they are ordered, and what they are called.

• Enable test mode to verify your order fulfillment workflow.
• Use specific test card numbers to simulate different transaction outcomes.
• Validate express checkouts and B2B settings for a complete overview.
• Optimize the final checkout experience by hiding or reordering methods.

To gain full control over your checkout and provide a more relevant payment experience for your customers, you can [try HidePay on Shopify] today.

FAQ

Can I use a real credit card when test mode is enabled?

No, when test mode is enabled on Shopify Payments or the Bogus Gateway, real credit cards will be rejected. The system is designed to only accept the specific test card numbers provided by Shopify. If you need to test with a real card, you must disable test mode and process a small transaction, which you can then refund.

Do test orders appear in my financial reports?

Test orders and simulated transactions do not appear in your Shopify payouts or financial reports. They are excluded from your total sales data to ensure your business analytics remain accurate. However, they will appear in your "Orders" list with a specific tag or banner indicating they were placed in test mode.

Why are some payment methods hidden when I enable test mode?

Certain local payment methods, like iDEAL, Sofort, or various "Buy Now, Pay Later" (BNPL) services, require a live connection to an external bank or service provider. These are often automatically hidden by Shopify during test mode because the external providers do not always support a simulated environment through the Shopify admin.

How do I test Shop Pay specifically?

To test Shop Pay, you must have Shopify Payments test mode active. When you add a test card to your Shop Pay account, you should enter the text test_card into the optional nickname field for that card. This allows the Shop Pay system to process the transaction as a simulation using your Shopify Payments test settings.

---

HidePay — free to install.