Subscription lifecycle

A member subscription links a member to a plan. It follows this cycle:

Pending → Active → ( Suspended | Cancelled | Expired )

• Suspended is reversible to Active.
• Cancelled and Expired are terminal.

Detailed steps

1. Creation (Pending)

You subscribe a member to a plan from their profile. Snapshot of plan + pricing + period is copied onto the subscription.

A first Invoice is generated in Sent status.

2. Activation (Active)

As soon as the first invoice becomes Paid, the subscription becomes Active. The member has club access.

3. Automatic renewals

Each day, Kimono auto-checks:

• If ends_at falls within the next 7 days AND status is Active, generate a new invoice for the next period.
• If ends_at <= now, the subscription becomes Expired.

The 7-day horizon gives the member time to pay before the current commit ends.

4. Manual suspension

Typical case: 3-month injury, long trip.

• On the subscription, action Suspend.
• Status → Suspended. Kimono stops generating renewal invoices.
• To resume, action Reactivate → status Active. ends_at is pushed back by the suspension duration.

5. Manual cancellation (Cancelled)

The member leaves for good.

• Action Cancel.
• Status → Cancelled. No future invoices.
• Already-issued invoices remain payable (unless separately cancelled).

Use case — freeze a subscription for 1 month

Pierre has knee surgery and wants to pause for 4 weeks.

1. Member profile → Subscriptions tab → Suspend.
2. Note the reason + expected resume date.
3. No invoice is generated during the suspension.
4. On return, Reactivate → subscription resumes with ends_at pushed by the suspension days.

Use case — amicable cancel with invoices still due

Marie cancels mid-year but still owes 3 months.

1. Cancel the subscription → no future invoices.
2. Check Finances → Unpaid: the 3 owed invoices remain in Sent / Overdue.
3. You can let them stand, manually cancel them (goodwill), or offer a payment plan.

Use case — plan switch mid-year

Member moves from Monthly to Annual.

1. Cancel the monthly subscription.
2. Subscribe to the annual plan.
3. Unpaid monthly invoices remain due (handle manually if you want to cancel them).
4. The member is Active on both until the monthly expires or is cancelled.

Unpaid member status

When a member has at least one Overdue invoice, Kimono auto-flips them from Active → Unpaid (daily check). Once all invoices are Paid again, back to Active.

It's automatic. You only need to act by reaching out.