> ## Documentation Index
> Fetch the complete documentation index at: https://docs.1club.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Per-session plans

> Bill a member each month for the sessions their class runs, plus an optional fixed fee. Sell the plan with a class, cancel sessions for illness or a closure, give makeups, change a member's class, and read how each monthly charge is made up.

A per-session plan bills a member for the sessions their class actually runs each month, instead of a fixed price. The member holds a seat in every session of one recurring class, and each monthly charge is an optional fixed fee plus the price of each of that month's sessions. Academies, swim schools, and squads use it; staff sell it and families see one clear charge a month.

## When to use it

Use a per-session plan when what a family owes depends on how many sessions the group runs, not on the calendar month.

* **A tennis academy** charges "sessions × €34 + a €25 club fee". A month with 13 training days costs more than a month with a holiday break, and nobody adds it up in a spreadsheet.
* **A swim school closes the pool for a gala.** You cancel that day's sessions as **Club cancelled**, and every family on the class is credited on their next charge.
* **A child breaks an arm.** You cancel their next three weeks as **Injury or illness**, so those sessions are not billed. If they come back sooner, you reinstate the sessions.
* **A second child joins.** A family discount for siblings comes off the sessions of every child after the first, at each monthly charge.

## How it works

### What the member holds

Selling a per-session plan puts the member in one recurring class. They get a booking in every session of that class from their start date on, each booked at no charge because the membership pays for it. These bookings show on your calendar and class rosters like any other.

The membership pays for its own class only. It pays for a booking in another class only as a [makeup](#makeups).

### How a monthly charge is made up

Each month is charged once, a few days before it starts (or on your [billing day](https://docs.1club.ai/sales/membership-billing.md#billing-day)), like any renewing membership. The charge is:

1. The plan's **Monthly fixed fee** (it can be 0).
2. Plus every session of the member's class that starts in that month and is not cancelled, each at the price of a seat in that session. That price is the class price after your [pricing rules](https://docs.1club.ai/settings/pricing-rules.md), so a winter and a summer rate are simply a date-range pricing rule.
3. Minus the best auto-applied [promotion](https://docs.1club.ai/sales/promotions.md) the member qualifies for on that day, such as a sibling discount. It comes off the sessions, never the fixed fee.
4. Plus or minus corrections for earlier months: a session you cancelled or added after its month was charged.
5. Minus any credit left over from an earlier charge.

A charge never goes below zero. What it can't use is carried to the next charge, so no credit is lost.

Example: 13 sessions × €34, a 10% family discount (€44.20), the €25 fee, and a €34 credit for a session the club cancelled last month: `13 × 34.00 − 44.20 Family discount + 25.00 − 34.00`, so €388.80.

### Corrections

A month is charged before it runs, so you may cancel or add a session after the charge was taken. 1club never charges that month again. The next charge looks back at up to three earlier months and settles the difference: a credit for a session that no longer runs, a charge for one that was added. Sessions the member simply skipped still ran, so they stay billed.

The last month of a membership that ends has no next charge to correct it. Settle any difference by hand from [Charges](https://docs.1club.ai/sales/charges.md).

### Cancelled sessions and makeups

Why a session is cancelled decides what the member gets:

| Reason picked when cancelling | Next charge | Makeup |
| - | - | - |
| **Club cancelled** | Not billed, or credited if already charged | No |
| **Injury or illness** | Not billed, or credited if already charged | No |
| **Member cancelled**, **Rescheduling**, or **Other**, in time | Still billed | One makeup owed |
| **Member cancelled**, **Rescheduling**, or **Other**, too late | Still billed | No |

"In time" follows your [cancellation rules](https://docs.1club.ai/settings/booking-policies.md#cancellation-rules): a cancellation the policy refunds any part of returns the session, so it owes a makeup. When you cancel later than that, the dialog asks what happens to the membership session, and **Return the session to the membership** owes a makeup anyway. A member who cancels a session from your portal or app is recorded as **Member cancelled**.

Whether an illness is long enough to excuse is your call when you pick the reason. The plan holds no rule for it.

### Per-session plans compared with other plans

| | Per-session plan | Ordinary renewing plan |
| - | - | - |
| Price each month | Fixed fee plus that month's sessions | The same stored price |
| Who sells it | Staff only | Staff, or members online |
| Session limit | None; each session is billed | Optional |
| Billing frequency | Monthly only | Any |
| Pause | Not available; cancel sessions as **Injury or illness** | Available |
| Auto-applied discount | Read again at every charge, off the sessions | Fixed into the price at the sale |

## Create a per-session plan

Go to **Sales** > **Plans** and click **+** (**Add Plan**), or open an existing plan. See [Plans](https://docs.1club.ai/sales/plans.md) for the rest of the dialog.

1. In **Pricing**, turn on **Bills the sessions of a class**. 1club sets **Type** to **Monthly** and locks it, turns on **Default Auto Renewal**, and adds **Classes** to what the plan covers.
2. Enter the **Monthly fixed fee**, for example your club fee. Leave it at 0 to bill the sessions only.
3. In **Validity**, leave the session limit empty. A per-session plan has one session limit row, with no number of visits.
4. Under **Covers**, keep **Classes**. Narrow it to class types or a program to limit which classes a makeup can be booked into.
5. Save.

The session rate is not on the plan. Set it on the class, or with a pricing rule. A change reaches the next charge, not one already taken.

A per-session plan can't be a [season plan](https://docs.1club.ai/schedule/season-passes.md). Members never see it in your plans list, on your website, in signup forms, or at checkout, whatever its **Visibility**: a family can't pick a class there, so you place each member yourself.

## Sell it

1. On **Sales** > **Memberships**, click **Add** > **Add Membership**, or start from the member's profile.
2. Pick the contact and the per-session plan.
3. Set the **Start Date**.
4. Pick the **Class** the member joins. Only recurring classes are listed. Saving without one shows "Choose the class this plan bills."
5. Check the summary. **Sessions this period** shows the sessions in the first period, for example "9 × €34.00", then any discount and the **Total due**. The first charge is the full fixed fee plus those sessions, with no share worked out by the day: 9 × €34 + €25 = €331.
6. Take payment now, or save and collect it later.

The member is booked into every session of the class from the start date. Don't pick a discount in the dialog: 1club applies the best auto-applied promotion itself, at the sale and at every charge.

When the membership ends or is cancelled, the member's remaining sessions of the class are released.

## Record an absence or a closure

Cancel the sessions with the reason that fits. You don't change the membership.

* **One session** - open the booking, click **Cancel booking**, pick **Injury or illness** or **Club cancelled**, and confirm. The dialog says "The session is not billed, so no makeup is owed."
* **Several sessions** - on [Bookings](https://docs.1club.ai/schedule/bookings.md), find the member's sessions, select them, click **Cancel N**, pick the reason, and confirm.
* **A session the club closes** - open the class session and choose **Cancel** from **More actions** (see [Classes](https://docs.1club.ai/schedule/classes.md#cancelling-vs-deleting)). Every booking in it is cancelled as **Club cancelled**, so every member on the class is credited.

A session cancelled before its month is charged is left off that charge. One cancelled after is credited on the next charge.

To undo an **Injury or illness** cancellation, for example when the child comes back sooner, open the cancelled booking and click **Reinstate**. The session is booked and billed again.

## Makeups

A makeup is a free session in another class, owed for a session the member cancelled in time.

* **Where you see them** - the membership's **Usage** reads "1 makeup owed" (or "No makeups owed"), in the memberships list and on the membership page. Members see "Makeups to book: 1" on their membership while one is owed.
* **Booking one** - the member, or a parent on their household account, books any class the plan covers from your portal or app and uses the membership to pay. It costs nothing and uses one makeup. Staff book one the same way from the booking dialog.
* **Cancelling one** - a makeup cancelled in time is owed again.
* **How long they last** - as long as the membership. They don't expire on a date.

With no makeup owed, the membership can't pay for a booking outside its own class. Staff picking it in the booking dialog see "No makeups owed: this membership covers its own class", and members see "No makeups to book". The member can still pay for the booking another way.

## Change a member's class

1. Open the member's booking in the first session of the old class they will no longer attend.
2. Click **Cancel booking**, choose **Cancel this and all future bookings in the series**, pick a reason, and confirm. The dialog says "The member's place in this class ends: sessions from this one on are not billed." These sessions owe no makeup.
3. Create a **Class** booking for the member in the first session of the new class, turn on **Recurring booking**, and choose their per-session membership to pay for it.

The member now holds a seat in every session of the new class from that day. Each month is billed for the days they held each place, and a change made after a month was charged is settled on the next charge. A membership holds one class at a time: until the old place is ended, the new booking is refused with "This membership already holds a place in a class. Cancel that place from a session on first."

## A family discount for siblings

1. Turn on **Relationship** tags in [Smart tagging](https://docs.1club.ai/settings/smart-tagging.md#relationship). The **Sibling** tag marks every child of a household after the first one who holds a membership.
2. Create a discount [promotion](https://docs.1club.ai/sales/promotions.md) with **Auto-apply** on, **Applies to** set to **Selected plans** and your per-session plans, and the **Sibling** tag as its audience.
3. Turn off **First purchase only** if a child may have held another plan before.

Each monthly charge reads the member's tags on that day, so the discount starts and stops with the family: it applies from a second child's first month, and stops if the older child leaves. When several auto-apply discounts fit, the one that takes the most off applies. Each charge counts as a redemption towards the promotion's caps.

## Read a charge

The monthly charge's reference names the plan and the month, then how the charge adds up, for example `13 × 34.00 − 44.20 Family discount + 25.00 − 34.00`. It reads the same on [Charges](https://docs.1club.ai/sales/charges.md), on the membership's **Charges** tab, on invoices, and in the payment confirmation. The last figure is the corrections and carried credit together. When the sessions cost different amounts, the sessions show as a count and a total instead, for example `13 = 450.00`.

Before a charge is taken, the amount shown is what will be charged:

* The membership's **Next charge** and the [Membership billing](https://docs.1club.ai/sales/membership-billing.md) tab quote it from the class's sessions, discount, and corrections.
* The **Renew** dialog shows the same amount as its **Price**.
* In the memberships list, the **Price** column reads "€25.00 + per session".

## What members see

* Their membership's price reads "€25.00 + per session", or "Per session" with no fixed fee.
* "Makeups to book" with the number owed, while there is at least one.
* Their sessions as bookings in their account, and one charge a month.

Members can't buy or pause a per-session plan themselves.

## Troubleshooting

| What you see | Why | What to do |
| - | - | - |
| Saving the plan fails with "A per-session plan has no session limit: each session is billed." | The session limit row has a number of visits. | Clear the number so the row is unlimited. |
| Saving the plan fails with "A per-session plan covers classes." | **Classes** was removed from what the plan covers. | Add **Classes**, or class types, under **Covers**. |
| Pausing fails with "This membership cannot be paused." | A per-session membership can't be paused. | Cancel the sessions the member misses as **Injury or illness**. |
| A member was billed for a session they missed | It was cancelled as **Member cancelled**, or not cancelled at all. | If you excuse a session that wasn't cancelled, cancel it as **Injury or illness**: it is credited on the next charge. One already cancelled for another reason can't be changed, so settle it by hand from [Charges](https://docs.1club.ai/sales/charges.md). |
| A correction you expected isn't on the charge | The session is more than three months back, or the membership has ended. | Settle it by hand from [Charges](https://docs.1club.ai/sales/charges.md). |
| The family discount isn't applied | The child has no **Sibling** tag, or the promotion doesn't target this plan. | Check the member's tags and the promotion's **Applies to** and audience. |

## Platform API and MCP

* A plan carries `chargesPerSession`. See [Plans](https://docs.1club.ai/api-reference/channel-integration/plans.md).
* `create_membership` (`POST /v1/platform/memberships`) takes `classId` for such a plan: any session of the recurring class. See [Memberships](https://docs.1club.ai/api-reference/channel-integration/memberships.md).
* `cancel_booking` takes `reasonCode`: `member_request`, `club_cancelled`, `rescheduling`, `medical` (injury or illness), or `other`. See [Bookings](https://docs.1club.ai/api-reference/channel-integration/bookings.md#cancel-a-booking).
* `get_membership` returns `nextCharge`, with what it is made of, and `usesRemaining` as the makeups owed.
* `update_membership` (`PATCH /v1/platform/memberships/{id}`) with `classId`, sent on its own, moves the member to another class: any session of the new class, from which they hold a seat in every session of it. Their place in the old class ends just before, and those sessions owe no makeup. See [Memberships](https://docs.1club.ai/api-reference/channel-integration/memberships.md).

## Related

* [Plans](https://docs.1club.ai/sales/plans.md) - the rest of the plan dialog.
* [Memberships](https://docs.1club.ai/sales/memberships.md) - selling and managing memberships.
* [Membership billing](https://docs.1club.ai/sales/membership-billing.md) - when renewals are charged and how they are collected.
* [Bookings](https://docs.1club.ai/schedule/bookings.md) - cancelling and reinstating sessions.
* [Classes](https://docs.1club.ai/schedule/classes.md) - recurring classes and their price.
* [Pricing rules](https://docs.1club.ai/settings/pricing-rules.md) - seasonal and other session rates.
* [Promotions](https://docs.1club.ai/sales/promotions.md) - auto-applied discounts.
* [Smart tagging](https://docs.1club.ai/settings/smart-tagging.md#relationship) - the **Sibling** tag.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.