Shopify Payments

Shopify Manual Payment Capture in Test Mode: Online Store vs. POS Explained

Hey everyone! As your friendly Shopify expert, I often dive into the community forums to see what real store owners are grappling with. It’s always fascinating to see the unique challenges and brilliant solutions that emerge. Recently, a thread titled "Manually capture payments in test mode" caught my eye, and it turned into a fantastic discussion that really highlighted some subtle but critical differences in how Shopify handles payments, especially when you throw Shopify POS into the mix.

The original question came from Paul (p_mac), who was trying to test a delayed payment capture workflow on his non-production store. He wanted payments to be authorized, but not captured immediately, giving him time to review orders before finalizing the charge. He’d set his store’s Payment capture method to Manually in his Shopify Payments test mode, but to his surprise, payments were still being automatically captured right after checkout. Frustrating, right?

Shopify order details showing 'Capture payment' button for an authorized transaction
Shopify order details showing 'Capture payment' button for an authorized transaction

Untangling the Initial Payment Puzzle: Bogus vs. Shopify Payments Test Mode

This is a common hurdle many merchants hit, and the community was quick to jump in with some initial troubleshooting. One of the first things Ecom_swift_LLC pointed out was a classic gotcha: the distinction between Shopify’s default “Bogus Gateway” and Shopify Payments in actual test mode. Many development stores default to the Bogus Gateway, and here’s the kicker: transactions through the Bogus Gateway always auto-capture instantly, regardless of your manual capture setting. It’s designed for basic functionality testing, not for granular payment flow. So, if you're seeing payments go straight to PAID and the transaction type is SALE, this could be your culprit.

To properly test manual capture, you absolutely need to be using Shopify Payments itself, with test mode toggled on in your store's Settings > Payments. Once Shopify Payments is active and in test mode, it will respect your manual capture setting. As Josh-FiveAcreCode confirmed, when configured correctly, a test payment (using the universal test card 4242 4242 4242 4242) will result in an "Authorized" status and present a "Capture payment" button in your order admin.

How to Configure Shopify Payments for Manual Capture Testing:

  • Enable Shopify Payments: Ensure Shopify Payments is your active payment gateway.
  • Toggle Test Mode: Navigate to Settings > Payments in your Shopify admin, find Shopify Payments, and ensure "Enable test mode" is checked.
  • Set Capture Method: In the same Settings > Payments section, under "Payment capture method," select Manually.
  • Use the Right Test Card: For credit card payments, always use the Shopify Payments test card number: 4242 4242 4242 4242 (any future date, any CVV).
  • Test in Online Store: Conduct your test transaction through your online store checkout, ideally in an incognito browser window to avoid caching issues. Avoid accelerated checkouts like Apple Pay or Google Pay for this specific test.

If you follow these steps, your online store orders should show as "Authorized" and await your manual capture, allowing you to thoroughly test your fulfillment workflows.

The Shopify POS Conundrum: A Different Beast Entirely

Just when Paul thought he had it figured out, he uncovered another layer of complexity – the Shopify POS (Point of Sale) app. He realized the payment behavior was different between the Admin/online store and the POS app, even when using the same payment gateway. This is where Ryan-BuildShed provided crucial clarity.

The manual payment capture setting in Settings > Payments only applies to online store orders. Shopify specifically states that POS orders are not affected by this setting. For Shopify Payments on POS Pro, card payments are authorized first and then automatically captured after a delay of up to 15 minutes. During this brief window, the order should show as "Authorized," giving you a small window to cancel it if there’s a mistake. However, you cannot configure POS to behave like the online store, where payments remain authorized indefinitely until you manually capture them.

This distinction is critical for merchants operating both online and physical retail. The immediate, albeit slightly delayed, capture on POS is designed for the fast-paced nature of in-person transactions, where a customer is typically waiting for their purchase to be finalized. It prevents situations where a customer leaves the store, but their payment is never captured due to an oversight.

Key Takeaways for Shopify Merchants

Understanding these nuances is vital for accurate testing and smooth operations, especially if you're managing a hybrid online and brick-and-mortar business. Here’s a summary of what you need to remember:

  • Bogus Gateway = Instant Capture: Use only for basic functionality tests. It will always auto-capture.
  • Shopify Payments Test Mode (Online Store) = Manual Capture Possible: This is where you can properly test delayed capture. Ensure settings are correct and use the 4242... test card.
  • Shopify Payments Test Mode (POS) = Delayed Auto-Capture: POS transactions will authorize and then automatically capture within approximately 15 minutes. Indefinite manual capture is not an option for POS.

By keeping these distinctions in mind, you can avoid frustrating test results and ensure your payment workflows are thoroughly vetted for both your online store and your physical retail locations. Proper testing prevents costly errors and ensures a seamless experience for your customers, no matter how they choose to shop.

Whether you're fine-tuning your current operations or considering a move to a more robust platform like Shopify, understanding these nuances is key. If you're grappling with complex Shopify setups, payment gateway configurations, or looking to migrate your store, our team at Shopping Cart Mover is here to help you navigate these challenges with expertise and precision.

Share:

Use cases

Explore use cases

Agencies, store owners, enterprise — find the migration path that fits.

Explore use cases