# Subscriptions

https://docs.wisecp.com/fr/subscriptions

See who collects each recurring payment, and stop a renewal you do not want.

## Reaching the Screen

Panel menu: **Billing** then **Subscriptions**: `{admin}/invoices/subscriptions`

The menu appears while the invoicing system is on. Each tab also opens from the address, with `?subtab=gateway` or `?subtab=autopay`.

## What Is on the Screen

Two tabs, one row per recurring collection. Who takes the money decides the tab.

- **Gateway Subscriptions**: Agreements held at a payment gateway.
- **Auto-Renewals**: Services and domains that renew from here.

A download icon on each list bar exports the filtered set as csv, json or xml.

### Gateway subscriptions

A row is one agreement, not one service, and can cover several services and add-ons.

Filter by status (**Active**, **Suspended**, **Cancelled**, **Expired**) or by gateway (those holding an agreement). Search matches the record number, the gateway reference and the client.

### The subscription detail

The arrow at the end of a row opens the agreement: gateway and reference, status, cycle, amount and items.

For active and suspended agreements the status is asked of the gateway. A tick means it confirmed; a warning line means you are reading the local record.

The foot offers **Sync Gateway Amount** when the amount has drifted and the gateway accepts a change. **Cancel Subscription** appears while the agreement is active. Items go one at a time while more than one remains.

### Auto-renewals

A row is one service or domain with auto-renew on, with no agreement at a gateway.

The renewal invoice is raised as usual. The daily automation collects from balance first, then the stored card.

Only rows that can still renew are listed: **Active**, **Suspended** and **In Progress**. Services inside a gateway agreement sit on the first tab.

Filters narrow by status and by type, **Service** or **Domain**. Search matches the number, the name and the client.

## Fields

### Gateway subscription columns

- **Client**: The agreement's owner.
- **Gateway**: The payment module holding it, with its reference.
- **Cycle**: How often the gateway collects. One agreement, one cycle.
- **Amount**: What the gateway takes next, in the agreement's currency. A second line appears when today's prices differ.
- **Next Payment**: When the gateway collects again; empty where it gives no date.
- **Last Paid**: The last collection recorded; empty means the first charge is due.
- **Items**: How many services and add-ons the agreement covers.
- **Status**: The agreement's own state, not that of the services inside: **Active**, **Suspended**, **Cancelled** or **Expired**.

### Auto-renewal columns

- **Client**: Whose service it is; the balance and card used are this account's.
- **Service**: The service or domain, linked to its record.
- **Cycle**: The renewal period the service is on.
- **Next Collection**: The service's due date. The renewal invoice is raised ahead of it.
- **Estimated Amount**: What the next renewal would total: today's price, or the stored price where locked. A guide, not a charge.
- **Collection Source**: What the collection draws on: a **Balance** mark, the card to be charged, or **No source**. An expired card is red.
- **Status**: The service's own status, not the collection's.

## Tasks

### Check what an agreement is charging

1. Filter to **Active** or search the client.
2. Open the row with the arrow at its end.
3. Read the amount against the items below; today's total is the **Current Total** row.

### Remove one item from an agreement

1. Open the agreement and find the item's row.
2. Use **Remove from Subscription** at the end of that row and confirm.
3. The item leaves, and the gateway drops that line or lowers the amount.

### Bring the gateway amount up to date

1. Open an agreement carrying the **Price Mismatch** mark.
2. Click **Sync Gateway Amount** and confirm. The module needs **Update Subscription Fee** on.
3. The recurring amount becomes today's total and the mark clears. The same sync runs hourly.

### Cancel an agreement

1. Open the agreement; the button is offered while it is active.
2. Click **Cancel Subscription** and confirm.
3. The agreement closes at the gateway and the row moves to **Cancelled**. The services keep running at today's prices.

### Turn off auto-renew for a service

1. Open the **Auto-Renewals** tab and find the row.
2. Use **Turn Off Auto-Renew** at the end of the row and confirm.
3. The row leaves the list. Open renewal invoices return to manual payment unless the account pays automatically.
4. Turn it back on from the service itself.

## Things to Watch

> **Cancelling cannot be undone**
> 
> There is no re-open here. A client who wants it back subscribes again from their own panel. The services keep running, and their renewals become invoices the client pays.

> **Removing one item can end the agreement**
> 
> Where the gateway cannot change an agreed amount, removing a line cancels the whole agreement. Removing the last item always ends it. Read the **Items** count first: it shows how many services the action reaches.

> **A live agreement freezes its prices**
> 
> A live agreement whose amount cannot reach the gateway bills its services at the stored price. The invoice matches what the gateway takes, so a catalogue price change misses these clients. Close the gap by syncing or cancelling.

## Required Privileges

The screen opens for `INVOICES_LOOK` or `INVOICES_OPERATION`; at that level you can only read. Actions need `SERVICES_OPERATION`, and exporting a list needs `TABLE_EXPORT`.

## Related Articles

- [Invoices](https://docs.wisecp.com/en/invoices)
- [Payment Modules](https://docs.wisecp.com/en/payment-modules)
- [Service Detail Overview](https://docs.wisecp.com/en/service-detail-overview)
- [Automation Overview](https://docs.wisecp.com/en/automation-overview)
