# Subscriptions

> See who pays you on a repeating schedule, which cards failed and when each person is charged next.

Source: https://docs.personacart.com/commerce/subscriptions

In short: {"See who pays you on a repeating schedule, which cards failed and when each person is charged next."}

- Anything a customer pays for on a repeating schedule (a membership, a subscription box, a monthly class pass) lives here as a subscription.
- This tab shows who pays you, what they pay, which cards failed and when each person is charged next.
- Open one member for the full story: [Subscription detail](/commerce/subscription-detail).

Video: Subscriptions: see who pays you every month (https://www.youtube.com/watch?v=7n4pqcb06oQ)

1. Open **Commerce → Orders** and choose **Subscriptions**.
2. Pick a view, such as people who need attention.
3. Use a safe button, such as **Send a reminder**.

## Where to find it

Sidebar → COMMERCE → Orders, then the **Subscriptions** tab. (On narrow screens the tab is called **Subs**.) To see a particular view, add `?view=` to the address, for example `?tab=subscriptions&view=needs_attention`.

## The top of the page

Three cards summarise the people who pay you:

- **Coming in this month:** the amount expected, per currency. It is "Expected, not yet received".
- **Paying members:** how many people are paying you.
- **Need you:** how many members have a card that did not work.

- If any cards failed, a box explains: "This happens a lot: the card expired or the bank said no. The member is not removed. We email them. You can also send a reminder now." It has **Send a reminder** (or **Send a reminder to all N**) and **See who**.
- After sending, a message says how many reminders went out; if some did not, it says "We sent X of Y reminders. The rest did not go out. Try again."

Before you have any members the page shows an example, marked **Example** ("Nothing is saved. It goes away when your first member joins") and a button **Go to Products** to make a membership.

A three-step guide shows how to use the page: **See who pays you**, **Open one member**, **Learn the three safe buttons**.

## Views, search and sorting

A row of views narrows the list: **All**, **Needs attention**, **Cancelling**, **Paused**, **Trial**, **Free** and **Cancelled**. Each shows a count.

- **Search ID, name, email...** finds a subscription by its number, the customer's name or email.
- The **Renews** menu filters by next charge date: **Any**, **Today**, **Tomorrow**, **Day after**, **Next 7 days**, or **Pick dates...** with a **From** and **To** date, then **Apply**.
  - The heading then reads for example "Renewing tomorrow · 4 subscriptions".
  - If nothing renews then, it says "No renewals on tomorrow" and offers **Clear**.
- Sort by **Subscription**, **Customer**, **Product**, **Last renewed**, **Next charge** or **Date created**. Click a column heading, or use the sort menu and its arrow to flip the direction.
- **Show more** loads the next set.

## The table

| Column | What it shows |
| --- | --- |
| **Subscription** | The subscription number and a status chip: **Active**, **Trial**, **Paused**, **Waiting for first payment**, **Cancels `{date}`**, **Payment failed** (with a count of tries), **Cancelled** or **Ended**. Test subscriptions are dimmed. |
| **Customer** | Name with customer number, and email. |
| **Product** | The product, its price per month, quarter or year (or **Free**), and for Academy the class or child. |
| **Last renewed** | When it last renewed, "Never renewed", or **Imported** history. |
| **Next charge** | A line that reads **Renews `{date}`**, **Paid until `{date}`**, **Trial ends `{date}`**, **Resumes `{date}`** or **Ended `{date}`**. |
| (last column) | The one next action for the row (below). |

- The next action depends on the state: **Ask to update card** for a failed payment, **Undo cancel** for a member who is leaving, **Resume** for a paused one, or **View**.
- Click anywhere on a row to open a quick panel with the member's **Next payment**, **Card** (brand and last four digits, or "Not on file") and **Member since**, the safe actions, and **Open full details**.

## The safe buttons

Each button tells you what will happen before you press it.

| Button | What it does |
| --- | --- |
| **Send a reminder** | Emails the member a link to fix the card. Nothing is charged and nothing else changes. |
| **Pause payments** | No charges while paused. The member keeps access. Choose **Start again on (optional)** or leave it empty to resume it yourself. |
| **Resume payments** | Charging starts again on the next payment day. |
| **Stop after this month** | Nothing more is charged. The member keeps everything until the paid period ends, then access ends and they get an email. You can undo it before then with **Keep this membership**. |
| **Stop right now** | Access ends today and nothing more is charged. No money is paid back. This cannot be undone. |
| **Keep this membership** | Cancels a scheduled stop. The member keeps paying as before. |

- When you stop a membership you may pick a reason only you see: **Too expensive**, **Not using it**, **Switched to another service**, **Missing features**, **Quality wasn't good enough**, **Too complicated**, **Customer service wasn't good enough** or **Other**.
- After pausing or stopping, a message appears with a link to undo.

## How renewals work

- Renewals run through your connected payment gateway on the cycle the buyer signed up for (**Monthly**, **Every 3 months** or **Yearly**).
- A successful charge creates a new [order](/commerce/orders) marked **Renewal**.
- A failed charge moves the subscription to **Payment failed** and the gateway's retry rules take over; the member is emailed and you can send a reminder yourself.

:::warning[Stop right now cannot be undone]
**Stop right now** does not refund anything and cannot be undone. Use **Stop after this month** when you want the member to keep the time they already paid for.
:::

## Questions

## What this screen looks like in every state

Before the first member it shows a labelled example. While loading it shows placeholders. If a search or filter has no result it says "Nothing here" and "No subscriptions match this view or search."
