Shopify payments app configuration screen - test mode

Topic summary

Main issue: Clarify how the “Test mode” toggle on an offsite Shopify payments app behaves across development and live stores, and whether toggling it notifies Shopify Payments.

Key answers/updates:

  • Visibility: The Test mode toggle is present on all stores (development and live). Real transactions cannot be enabled on development stores.
  • Communication: Changing the Test mode setting within the app does not communicate anything to Shopify Payments on the store. There is no automatic signal or webhook triggered by this toggle.

Implications:

  • Merchants toggling Test mode in the app will not change Shopify Payments’ state or processing mode. The app must handle test vs. live behavior internally.
  • Do not expect payment/refund session requests to reflect this toggle automatically unless implemented within the app’s logic.

Artifacts: A screenshot of the configuration screen was shared for context but is not required to understand the outcome.

Status: Questions answered; no further actions or unresolved disagreements indicated.

Summarized with AI on January 4. AI used: gpt-5.

Hi,

We are working on an offsite Shopify payments app, when we install the app on a development store, we get the following configurations screen.
I have 2 questions regarding the test mode option:

  • Does this option show on development stores only? or it will show on live stores as well?
  • If the shop admin toggles this option, how can the Shopify payments app know about it? is there a web hook that will be triggered? or this option will be reflected in the Shopify payment and refund sessions requests?

Thanks in advance.

Hi Hmk-Pmnt,

The test mode toggle will be on all stores - there’s no way to enable real transactions on a dev store. For your second question, changing this option on your app will not communicate anything to Shopify Payments on the store.