> 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/features/email-notifications/renewal-and-dunning-settings.md).

# Renewal & Dunning Settings

Choose when renewal payments are charged and how the app retries a payment that fails.

The app charges each subscription automatically when its next order is due. On the **Renewal & Dunning** settings page you decide:

* **when** renewals are charged: the time zone, the days, and the hours,
* **how** they are charged: on time or earlier, and whether out-of-stock items can still be billed,
* **what happens when a payment fails**: how many times the app retries it and how far apart (this is called **dunning**).

The page has two cards: **Renewal Settings** and **Dunning Settings**. Every setting applies to all subscriptions in your store.

## Change your settings

{% stepper %}
{% step %}

### Open Renewal & Dunning

In the app menu, click **Settings**, then click **Renewal & Dunning**.
{% endstep %}

{% step %}

### Set when renewals are charged

In the **Renewal Settings** card, choose a **Time Zone**, then turn on **Specific Days** or **Specific Hours** if you want to charge renewals only at certain times. Choose a **Billing Timing** and decide whether to turn on **Allow Overselling**. Each field is explained in [Renewal Settings](#renewal-settings) below.

![The Renewal Settings card with Time Zone, Specific Days, Start and End, and Billing Timing highlighted](https://3752025337-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F479XnzvtVA5dDE3Rt2Uh%2Fuploads%2FAOT6g3QACNROT4gIHrjN%2Frenewal-settings-card.png?alt=media)
{% endstep %}

{% step %}

### Set up payment retries

In the **Dunning Settings** card, keep the switch next to the card title on to retry failed payments. Set **Billing Retries** and **Retry Interval** for **Phase 1**, and click **Add phase** if you want a second stage of retries. See [Dunning Settings](#dunning-settings) below.

![The Dunning Settings card with the on/off switch and Add phase highlighted](https://3752025337-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F479XnzvtVA5dDE3Rt2Uh%2Fuploads%2FZUbtNCBSWQfnLkLlp1CA%2Fdunning-settings-card.png?alt=media)
{% endstep %}

{% step %}

### Save

Click **Save** in the bar at the top of the page. The settings apply to all subscriptions, so you do not need to edit them one by one.
{% endstep %}
{% endstepper %}

## Renewal Settings

| Field                 | What it does                                                                                                                                                                                                                                                                                                                                                | Default         |
| --------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------- |
| **Time Zone**         | The time zone used for **Specific Days** and **Specific Hours**, and for deciding when a renewal is due. The **Your browser** text next to the field shows your browser's time zone for reference. It is not the saved value.                                                                                                                               | UTC             |
| **Specific Days**     | Off: renewals are charged every day. On: renewals are charged only on the days you select. Turning it on selects **Mon** to **Fri**. Click a day to add or remove it.                                                                                                                                                                                       | Off (every day) |
| **Specific Hours**    | Off: renewals are charged at any time of the day. On: renewals are charged only between **Start** and **End**. If no hours were set before, turning it on fills in 08:00 to 18:00. The same hours apply to every selected day.                                                                                                                              | Off (any time)  |
| **Billing Timing**    | **On time** charges each renewal when it is due. **Same day, as early as possible** charges all renewals due today from the start of the day, or from the **Start** time when **Specific Hours** is on. **A set number of hours early** charges renewals up to the number of hours you enter (1 to 24) before they are due. You can choose only one option. | On time         |
| **Allow Overselling** | Off: renewals follow each variant's inventory policy in Shopify, so an out-of-stock item can make the renewal fail. On: renewals are charged even when items are out of stock.                                                                                                                                                                              | Off             |

**Reset to default** in the top-right corner of the card puts every field in **Renewal Settings** back to its default. It does not change **Dunning Settings**. Click **Save** to keep the reset.

{% hint style="warning" %}
Renewals follow the **Time Zone** in this card, which is **UTC** by default, not your Shopify store's time zone. If your store is in New York and you leave the default, a window of 09:00 to 17:00 means 09:00 to 17:00 UTC, which is 04:00 to 12:00 in New York in winter. Set **Time Zone** to your own time zone before you set days and hours.
{% endhint %}

### Rules for Start and End

* **Start** must be earlier than **End**. If it is not, the message "Start hour must be before the end hour" appears under **End** and the settings cannot be saved.
* Choose **24:00 (end of day)** in **End** to charge renewals until midnight.
* If **Start** and **End** are the same, renewals are charged at any time of the day, the same as turning **Specific Hours** off. A yellow banner tells you when this is the case.
* If you turn on **Specific Days** and remove every day, the banner "No billing days selected" appears. No renewals are charged until you select at least one day.

## How the billing time is decided

The app checks for due renewals every 10 minutes. A renewal is charged at the first check that is:

1. at or after its due time (or the earlier time set by **Billing Timing**), and
2. inside the days and hours you allow.

A renewal that falls due outside your allowed days or hours waits until the next allowed window opens. It is charged later, never earlier, unless you choose **Same day, as early as possible** or **A set number of hours early**.

**Example:** **Specific Hours** is 09:00 to 17:00 and a renewal is due at 20:00.

| Billing Timing                           | When the renewal is charged                                                                |
| ---------------------------------------- | ------------------------------------------------------------------------------------------ |
| **On time**                              | When the window opens on the next allowed day                                              |
| **Same day, as early as possible**       | Shortly after 09:00 the same day                                                           |
| **A set number of hours early**, 2 hours | When the window opens on the next allowed day, because 18:00 is already outside the window |

After the app sends the charge, Shopify processes the payment. The Shopify order is created only when the payment succeeds.

{% hint style="info" %}
Dates in the **Subscriptions** screens are shown in your browser's time zone, so the **Next Billing** time there can differ from the time zone set here. See [Subscriptions](https://subscriptions-docs.tech-arms.io/features/subscriptions.md).
{% endhint %}

## Dunning Settings

When a renewal payment fails, dunning makes the app try the payment again. Use the switch next to the **Dunning Settings** title to turn retries on or off.

Retries are organised in **phases**. Each phase has:

| Field               | What it does                                              | Allowed values |
| ------------------- | --------------------------------------------------------- | -------------- |
| **Billing Retries** | How many times the app retries the payment in this phase. | 1 to 14        |
| **Retry Interval**  | How long the app waits between retries in this phase.     | 1 to 7 days    |

The app runs **Phase 1** first. When its retries are used up, it moves on to **Phase 2**, and so on. Click **Add phase** under the last phase to add another one, up to 4 phases. Click the delete icon to remove a phase. A campaign always keeps at least one phase.

**Default:** dunning is on, with 1 phase of 3 retries, 1 day apart. Together with the original charge, that is 4 payment attempts over about 3 days.

Retries also respect **Specific Days** and **Specific Hours**. A retry that falls outside the allowed window waits until the window opens.

### What happens when a payment fails

Every failed attempt, including retries and charges you start yourself:

* changes the subscription status to **Failed**,
* sends the customer the **Payment failed (retrying) email** and you the **Payment failed email**, if those emails are turned on.

When the last retry fails, the customer also gets the **Payment failed (last attempt) email**. If dunning is off, the app does not retry, and the customer gets this email after the first failure.

After the last retry, **the app does not pause, cancel, or skip the subscription**. The failed billing cycle has no order, the subscription stays **Failed**, and the next cycle is still charged on its normal date. When a later payment succeeds, the subscription returns to **Active**, and the customer gets the **Subscription resumed email**.

To collect the failed cycle yourself, use **Recharge Cycle** in [Past orders](https://subscriptions-docs.tech-arms.io/features/subscriptions/past-orders.md). If you want to stop charging the customer, pause or cancel the subscription yourself.

### Out-of-stock items

When **Allow Overselling** is off and an item in the renewal is out of stock, Shopify rejects the charge. The app handles it exactly like a failed payment: the subscription becomes **Failed**, the failure emails are sent, and dunning retries the charge. In **Past orders**, the **Payment status** shows a reason such as **INSUFFICIENT\_INVENTORY**. Turn on **Allow Overselling** if you prefer to charge the renewal and fulfil the item when it is back in stock.

## Example configuration

A store in New York wants to charge renewals on weekdays during office hours, and to retry failed payments quickly at first and then more slowly.

| Setting               | Value                                            |
| --------------------- | ------------------------------------------------ |
| **Time Zone**         | America/New\_York                                |
| **Specific Days**     | On: **Mon**, **Tue**, **Wed**, **Thu**, **Fri**  |
| **Specific Hours**    | On: **Start** 09:00, **End** 17:00               |
| **Billing Timing**    | **Same day, as early as possible**               |
| **Allow Overselling** | Off                                              |
| **Phase 1**           | **Billing Retries** 2, **Retry Interval** 1 day  |
| **Phase 2**           | **Billing Retries** 2, **Retry Interval** 3 days |

With this setup, a renewal due on Tuesday at 20:00 is charged on Tuesday morning, shortly after 09:00. If that payment fails, the app retries on Wednesday and Thursday, then twice more 3 days apart. A retry that would fall on a Saturday or Sunday waits until Monday morning.

## Emails sent on failure

| Email                                   | Sent to  | When                                                                       |
| --------------------------------------- | -------- | -------------------------------------------------------------------------- |
| **Payment failed (retrying) email**     | Customer | After every failed attempt, including the last one                         |
| **Payment failed (last attempt) email** | Customer | After the last retry fails, or after the first failure when dunning is off |
| **Payment failed email**                | You      | After every failed attempt                                                 |
| **Subscription resumed email**          | Customer | When a later payment succeeds and the subscription returns to **Active**   |

With the default settings, one renewal that keeps failing sends the customer 4 **Payment failed (retrying)** emails and 1 **Payment failed (last attempt)** email.

{% hint style="warning" %}
Review the default text of these emails before you rely on them:

* The default subject of **Payment failed (last attempt)** is the same as the retrying email ("Your payment failed and will be retried"), and its body says the subscription is "at risk of being suspended". The app never suspends a subscription on its own, so edit the subject and text to match what you will do.
* The default subject of the **Upcoming Order Reminder Email** says the subscription "has been cancelled". Change it before you turn this email on.
  {% endhint %}

To turn emails on or off and edit their text, see [Email Notifications](https://subscriptions-docs.tech-arms.io/features/email-notifications/email-notifications.md).

## Good to know

* The settings apply to all subscriptions at once. You cannot set different billing days, hours, or retries for one selling plan or one subscription.
* A narrow window, such as one hour on one day a week, can delay renewals and retries by several days. Keep the window wide enough for every renewal due in a day.
* Charges you start yourself, with **Recharge Cycle** or **Place Order**, can take up to 5 minutes.

*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/features/email-notifications/renewal-and-dunning-settings.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.
