> For the complete documentation index, see [llms.txt](https://subscriptions-docs.tech-arms.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://subscriptions-docs.tech-arms.io/admin/how-to-run-test-transactions-configure-settings-and-start-selling.md).

# How to run test transactions, configure settings, and start selling?

Place test subscription orders, check a renewal and the customer portal, and get your store ready to sell subscriptions.

Before you launch, place a few test orders to check the whole subscription journey: the widget, checkout, the subscription in the app, a renewal, and the customer portal. Test orders use test cards, so no real money is charged.

## Before you start

* Your store uses a payment provider that supports subscriptions. See [eligibility](https://subscriptions-docs.tech-arms.io/getting-started/must-read-shopify-subscriptions-app-eligibility-considerations.md).
* The app embed is on. See [Activate TA Subscriptions App](https://subscriptions-docs.tech-arms.io/getting-started/how-to-install-or-uninstall-our-subscription-app.md).

## Test a subscription

{% stepper %}
{% step %}

### Turn on test mode

Put your payment provider in test mode:

* **Shopify Payments:** follow Shopify's guide [Testing Shopify Payments](https://help.shopify.com/en/manual/payments/shopify-payments/testing-shopify-payments). It also lists the test card numbers.
* **Development stores:** you can use Shopify's [Bogus Gateway](https://help.shopify.com/en/manual/checkout-settings/test-orders) instead.
  {% endstep %}

{% step %}

### Prepare a test product

Use an existing product or create one for testing. The product must be active and available on your Online Store, otherwise customers (and you) can't check out with it. To keep it out of sight, don't add it to collections or menus.
{% endstep %}

{% step %}

### Add the product to a selling plan

In the app menu, click **Selling Plans** and create a plan for the test product. See [Create a selling plan](https://subscriptions-docs.tech-arms.io/features/subscription/how-to-create-a-subscription-plan.md).

To test renewals quickly, use a short **Delivery Frequency**, such as every 1 day.
{% endstep %}

{% step %}

### Place a test order

Open the product on your store. In the subscription widget, choose a plan, add the product to the cart, and check out with a test card. Use a customer email you can access, so you also receive the app's emails.
{% endstep %}

{% step %}

### Check the subscription in the app

In the app menu, click **Subscriptions**. The new subscription appears with the status **Active**. Open it to check the products, price, delivery frequency, and next order date. See [Contract details](https://subscriptions-docs.tech-arms.io/features/subscriptions/contract-details.md).

In the **Past orders** tab, the checkout order appears as **Billing Cycle 0** and is marked **First Order**.
{% endstep %}

{% step %}

### Test a renewal

You don't need to wait for the next billing date. Open the subscription, click the **Upcoming orders** tab, click **…** on the next order, and choose **Place Order**. See [Upcoming orders](https://subscriptions-docs.tech-arms.io/features/subscriptions/upcoming-orders.md).

The charge can take up to 5 minutes. The new order then appears in **Past orders** and in **Orders** in Shopify admin.
{% endstep %}

{% step %}

### Test the customer portal

On your store, open `/apps/subscription` (for example `https://your-store.com/apps/subscription`) click **Please login to access your account**, and sign in with the test customer's email. Try the actions you allow, such as skip, reschedule, or pause. See [Customer Portal](https://subscriptions-docs.tech-arms.io/features/customer-portal.md).
{% endstep %}
{% endstepper %}

## Configure your settings

While you test, review the settings that affect live subscriptions:

| Setting                 | Why check it                                                                                                                                                 | Guide                                                                                                                     |
| ----------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------- |
| **Renewal & Dunning**   | When renewals are charged and how failed payments are retried. Renewals follow the app's **Time Zone**, which is UTC by default, not your store's time zone. | [Renewal & Dunning](https://subscriptions-docs.tech-arms.io/features/email-notifications/renewal-and-dunning-settings.md) |
| **Email Notifications** | Which emails customers and you receive.                                                                                                                      | [Email Notifications](https://subscriptions-docs.tech-arms.io/features/email-notifications/email-notifications.md)        |
| **Customer Portal**     | Which actions customers can take themselves.                                                                                                                 | [Customer Portal](https://subscriptions-docs.tech-arms.io/features/customer-portal.md)                                    |
| **Widgets**             | How the subscription options look on the product page.                                                                                                       | [Widgets](https://subscriptions-docs.tech-arms.io/features/customization.md)                                              |

## Start selling

{% stepper %}
{% step %}

### Turn off test mode

Turn off test mode for your payment provider, so customers can pay with real cards.
{% endstep %}

{% step %}

### Cancel your test subscriptions

Open each test subscription and click **Cancel contract**. Test subscriptions can't be charged after test mode is off. If you leave them active, their renewals fail with an error such as `PAYMENT_METHOD_INCOMPATIBLE_WITH_GATEWAY_CONFIG`.
{% endstep %}

{% step %}

### Add your real products

Add the products you want to sell to your selling plans, or remove the test product from the plan. Then check the widget on a few product pages.
{% endstep %}
{% endstepper %}

## Good to know

* Test orders appear in Shopify admin with a test label and aren't real sales.
* If a test payment fails, check its error code in **Past orders**. See [Billing error codes](https://subscriptions-docs.tech-arms.io/resources/help-center/troubleshooting-guide.md).
* Want us to check your setup before you launch? [Book a call](https://calendly.com/ta-subscription-app-support/30min).

*If you need help, feel free to reach out to us via in-app* [***Live chat***](https://go.crisp.chat/chat/embed/?website_id=c4ae10a3-f762-4968-b35a-c931caf62a96)***,*** [***Book a call***](https://calendly.com/ta-subscription-app-support/30min) *or at* [***support@tech-arms.io***](mailto:support@tech-arms.io)***.***


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://subscriptions-docs.tech-arms.io/admin/how-to-run-test-transactions-configure-settings-and-start-selling.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
