> ## Documentation Index
> Fetch the complete documentation index at: https://help.coachiq.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Sell a Membership With Credits

> Set up a monthly membership that gives credits, let families spend them on your schedulers, and handle renewals, leftover credits and failed payments.

A credit membership bills a family on a schedule, usually monthly, and adds credits with each payment. Families spend the credits to book sessions on the schedulers you choose. Two settings have to agree: the **product** says how many credits each payment adds and where they work, and the **scheduler** says that its sessions cost credits.

Connect Stripe first. If you haven't taken a payment yet, start with [Take your first payment](https://help.coachiq.io/flows/take-your-first-payment.md).

## 1. Create the membership

**1. Start a Subscription product**

Go to **Payments → Products**, click **+ Create** and choose **Subscription**. You can't change the type later, so check it before you continue.

**2. Set the price and how often it bills**

Name it so families know what they get, such as "8 Sessions a Month", then enter the price and the billing frequency.

**3. Add the credits**

Turn on **Add Credits once Purchased** and set **Number of Credits** for each payment, or choose **Unlimited Credits** (families see **∞**).

**4. Choose what happens to leftover credits**

In the same **Credits** section, choose one: unused credits expire at each renewal, they carry over, or they carry over and each payment's credits expire a set number of days later. See [step 4](#4-renewals-rollover-and-expiry).

**5. Choose where the credits work**

Under **Credit Limits**, pick the schedulers in **Credits can be redeemed for these schedulers**. Leave it blank and they work on every scheduler that takes credits. For an unlimited membership, set a **Weekly booking allowance** so nobody books 30 sessions in week one.

**6. Save**

Click **Create** at the top right. If every member must agree to your waiver, turn on **Require Agreement to Terms** under **Advanced** first.

[Membership credits](https://help.coachiq.io/payments/credits/recurring-credit-memberships.md) · [Credit Limits](https://help.coachiq.io/payments/credits/credit-usage-limits-restrictions.md) · [Product builder: Credits](https://help.coachiq.io/payments/product-builder.md#credits)

## 2. Let families spend the credits

**1. Set the scheduler to Credit**

Open the scheduler under **Scheduling → Schedulers** and go to **Payment**. Choose **Paywalled**, then **Credit** (or **Either**, so families can pay the price or use a credit). Enter how many credits one booking costs.

**2. Add a Buy more credits link**

Paste your membership's link into **Buy more credits**. A family without enough credits is sent there instead of hitting a dead end.

**3. Decide what a cancellation does**

Under **Advanced settings → Booking Rules**, turn **Refund credits used on cancellation** on or off, and pair it with your cancellation notice window.

**4. Save and check both sides**

Save the scheduler. Then open the membership and check this scheduler is picked under **Credits can be redeemed for these schedulers**, or that the field is blank.

[Credits and schedulers](https://help.coachiq.io/scheduling/credits-and-schedulers.md) · [Set booking payments](https://help.coachiq.io/scheduling/setting-up-payment-options.md)

To make sessions members-only, use **Paywalled → Credit** and only sell those credits through the membership.

## 3. Sell it

Put the membership on the Products page of your app, link it from your website, or send the link from the product's **Product Link** section. A family who buys it gets the first payment's credits straight away, and sees the balance in your app under **Settings → Billing**.

Already have members paying you another way? Give them the membership from their profile: **People → Clients**, open the client, **Products**, **+ Add Product**. Paste their Stripe Subscription ID to link real billing, or leave it blank for a free grant. See [Manually adding products](https://help.coachiq.io/people/client-profiles/client-profiles-products.md#manually-adding-products) and [Bring new families into CoachIQ](https://help.coachiq.io/flows/bring-in-new-families.md).

[Products page in your app](https://help.coachiq.io/app/products.md) · [Where families find a product](https://help.coachiq.io/payments/product-overview.md#where-families-find-a-product)

## 4. Renewals, rollover and expiry

On each renewal Stripe charges the saved card. If it goes through, the membership stays active and the new period's credits are added. The client's **Credits** tab logs a **Renewal** row, and an **Expiration** row for any leftover credits that ended.

What happens to leftover credits depends on the choice you made in step 1. With 12 credits a month and 4 left:

| Option | After renewal |
| - | - |
| **Unused Credits Expire upon Subscription Frequency** | 12 |
| **Carry over unused credits** | 16 |
| **Carry over, and expire each payment's credits after a set number of days** | 16, and last month's 4 expire on their own date |
| **Unlimited Credits** | ∞ |

Credits stay usable through the end of their last day in your organization's time zone. To make sure a cycle's credits only cover sessions in that cycle, turn on **Sessions must occur by expiration** in the product.

[Unused credit behavior at renewal](https://help.coachiq.io/payments/credits/recurring-credit-memberships.md#unused-credit-behavior-at-renewal) · [When credits expire](https://help.coachiq.io/payments/credits/credit-system-overview.md#when-credits-expire)

## 5. When a payment fails

At the first failed charge the membership goes **Past due** and its credits pause. The balance is kept, but it can't be used to book until a payment goes through. The family can still sign in and book with Master Credits or by paying per session.

1. Go to **Payments → Subscriptions** and filter to **Past Due**.
2. Message the family. They update the card on that membership from **Billing** in your app.
3. Stripe retries on the schedule set in your Stripe account. When a payment succeeds, the credits work again. If the retries run out, Stripe cancels the subscription or marks it unpaid, depending on your Stripe settings.

[Failed payments](https://help.coachiq.io/payments/failed-payments.md)

## 6. Manage a member

Everything about one member is on their profile in **People → Clients**:

* **Products**: the membership, and **Cancel membership**. Choose **At end of billing period** to keep access through what they've paid for, or **Immediately**. Neither one refunds a payment.
* **Subscriptions**: the status, the price and **Manage**, which shows who pays, the card, the next payment and the latest invoice.
* **Credits**: the balance, the log, and **Adjust balance** to add or remove credits.
* **Transactions**: each payment, and **Refund payment**.

To see every membership at once, with past-due, paused and canceled ones, use **Payments → Subscriptions**.

[Cancel a membership](https://help.coachiq.io/payments/manage-subscriptions.md) · [Client profile: Subscriptions](https://help.coachiq.io/people/client-profiles/client-profiles-subscriptions.md) · [Client profile: Credits](https://help.coachiq.io/people/client-profiles/client-profiles-credits.md) · [Subscriptions dashboard](https://help.coachiq.io/payments/subscriptions-dashboard.md)

## Next

* [Change a member's plan](https://help.coachiq.io/payments/upgrade-membership.md)
* [Shared family memberships](https://help.coachiq.io/payments/shared-family-memberships.md)
* [Member discounts](https://help.coachiq.io/payments/coupon-sharing-and-limits.md#member-discounts): give members a lower price on camps and clinics.


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