Test a payments app
You can install your payments app on a development store to test it. This tutorial shows how to test and enable a development preview of your payments app.
What you'll learn
Anchor link to section titled "What you'll learn"In this tutorial, you'll learn how to do the following tasks:
- Fill out testing instructions for your payments app extension
- Install your payments app extension on a development store
- Enable the development store preview to test your changes
Requirements
Anchor link to section titled "Requirements"- You've created a payments app, submitted it for approval, and published a version.
- You've configured test mode for your payments app extension.
Step 1: Enable test mode for the payment gateway
Anchor link to section titled "Step 1: Enable test mode for the payment gateway"After you've configured test mode for your payments app extension, you need to enable test mode for the payment gateway.
When a payment gateway is in test mode, requests from Shopify include the test
attribute. If test
is set to true
, then the payment is processed as a test payment and no actual transaction is made.
Step 2: Fill out testing instructions
Anchor link to section titled "Step 2: Fill out testing instructions"You need to fill out the Testing instructions on the app listing with the following details:
- The credentials to enable installing the payments app for testing. For example, activation codes and login credentials.
- The instructions on how to process a test payment and refund
- A description of specific testing scenarios:
- Installments or deferred payments
- 3D Secure authentication, if applicable
- A screencast of how your payments app or payment flow works on each of the supported browsers.
Step 3: Install your payments app on a development store
Anchor link to section titled "Step 3: Install your payments app on a development store"You can install your app on a development store to test your app.
- From your Partner Dashboard, go to Apps.
- Click the app that you want to test.
- In the Test your app section, click Select store.
- Select the store that you want to install your app on.
- Click Install unlisted app.
Step 4: Enable development store preview
Anchor link to section titled "Step 4: Enable development store preview"You can enable the development store preview to test your changes quickly by using the draft version configuration instead of the published version on the development stores where your app is installed. This is useful to avoid going through the approval process to publish multiple versions during development.
When you test your payments app on a development store, the app needs to use the draft version configuration. If you disable the development preview, then the development store needs to revert to the published version.
- From your Partner Dashboard, go to Apps.
- Click the app that you want to enable a development preview for.
- Click Extensions.
- Select your payments app extension.
From the extension page, in the Working draft section, under Development store preview, click Enable.