Skip to Content
Z8Z8 Docs
Admin Guide

Billing & Subscriptions

Manage your z8 subscription, pricing plans, and billing settings

Overview

z8 uses a seat-based subscription model powered by Stripe. Each member of your organization counts as one seat: a full seat, or a cheaper kiosk seat for employees who only clock at kiosks. Organization administrators can manage their subscription, view billing details, and access invoices from the billing settings page.

Billing is only available when enabled for your z8 instance. Self-hosted deployments can operate without billing by leaving the BILLING_ENABLED flag disabled.

Pricing Plans

z8 offers two billing cycles with per-seat pricing:

PlanFull SeatKiosk SeatBilling CycleSavings
Monthly€4 / month€2 / monthBilled monthly-
Yearly€3 / month (€36 / year)€1.50 / month (€18 / year)Billed annually25% discount

Prices are net prices; VAT is added where applicable.

What Counts as a Seat

  • Each approved member of your organization counts as one seat
  • Demo accounts do not count
  • Former employees do not count: someone you deactivate stops counting at once, and someone whose departure takes effect stops counting after their last day
  • Reactivating an employee counts them again
  • Seat counts are automatically synchronized when employees are added or removed
  • The billing amount adjusts automatically based on your current seat count

Kiosk Seats

A kiosk-only employee has no sign-in and clocks only at kiosks. Their seat is a kiosk seat, billed at the kiosk seat price: €2 per month, or €1.50 per month billed yearly. Every other seat is a full seat at the ordinary price.

  • z8 recognizes kiosk-only employees by the reserved placeholder address z8 gives them instead of an email. You don't mark kiosk seats yourself.
  • Kiosk seats and full seats are separate lines on the same subscription and invoice, and both follow your billing cycle.
  • Adding a real email to a kiosk-only employee makes them a full seat at once, as soon as you save the email, not when they accept their invitation. Stripe prorates the difference.
  • The billing page lists full seats and kiosk seats with their prices, and the total matches your invoice.

Kiosk seats are available once both kiosk seat prices are configured (STRIPE_PRICE_KIOSK_MONTHLY_ID and STRIPE_PRICE_KIOSK_YEARLY_ID, on the web app and the worker). Until then, every seat is billed as a full seat and the kiosk seat price is not shown. On a deployment that already has subscriptions, run pnpm billing:reconcile-kiosk-seats once after setting both prices, so existing subscriptions move their kiosk-only employees to kiosk seats. The deployment README (deploy/README.md) describes this step.

Free Trial

New organizations receive a 14-day free trial when billing is enabled:

  • Full access to all features during the trial
  • No credit card is required to start the trial
  • A trial countdown appears in the app while the trial is active
  • Organization admins can add payment details during the trial with Stripe Checkout
  • If payment details are added during the trial, the paid subscription starts after the trial expires

Managing Your Subscription

Viewing Subscription Status

  1. Navigate to Settings > Billing in z8
  2. View your current subscription details:
    • Current plan (Monthly or Yearly)
    • Number of active seats
    • Full seats and kiosk seats, each with its price and subtotal
    • Monthly cost
    • Next billing date
    • Trial status (if applicable)

Subscribing to a Plan

  1. Go to Settings > Billing
  2. Select your preferred plan (Monthly or Yearly)
  3. Click Subscribe
  4. You'll be redirected to Stripe Checkout to enter payment details
  5. After successful checkout, you'll be redirected back to z8
  6. During a trial, the paid subscription starts after the trial expires

Changing Your Plan

To switch between Monthly and Yearly billing:

  1. Go to Settings > Billing
  2. Click Manage Subscription
  3. You'll be redirected to the Stripe Customer Portal
  4. Update your subscription plan
  5. Changes take effect at the next billing cycle

Updating Payment Method

  1. Go to Settings > Billing
  2. Click Manage Subscription
  3. In the Stripe Customer Portal, update your payment method
  4. Add or change credit card, SEPA, or other payment methods

Viewing Invoices

  1. Go to Settings > Billing
  2. Click Manage Subscription
  3. View and download past invoices in the Stripe Customer Portal

Canceling Your Subscription

  1. Go to Settings > Billing
  2. Click Manage Subscription
  3. In the Stripe Customer Portal, click Cancel Plan
  4. If cancellation is scheduled for the end of the billing period, access remains active while Stripe reports the subscription as active

After your trial expires or your subscription is no longer valid, your organization is suspended. Normal product pages and data-changing actions are blocked until an organization admin updates billing.

If a cancellation is scheduled for the end of the billing period, access remains active while Stripe reports the subscription as active. When Stripe reports the subscription as canceled, the organization is suspended immediately.

Subscription States

StateAccess LevelDescription
TrialingFull accessFree trial period active
ActiveFull accessSubscription is current and paid
Past DueSuspendedPayment failed; access is blocked until payment is resolved
CanceledSuspendedSubscription ended
UnpaidSuspendedPayment failed after all retries

Seat Synchronization

z8 automatically keeps your seat count in sync with Stripe:

  • When you add an employee, the seat count increases and billing adjusts pro-rata
  • When you deactivate an employee, the seat count decreases at once and Stripe prorates the difference; reactivating them adds the seat again
  • When you add an email to a kiosk-only employee, one kiosk seat becomes a full seat
  • The current seat count is always visible on the billing page

Platform Administration

This section is for platform administrators managing a multi-tenant z8 deployment. Organization admins can skip this section.

Platform administrators have access to a billing overview dashboard at Admin > Billing that provides:

MetricDescription
Monthly Recurring RevenueTotal MRR across all organizations, with full seats and kiosk seats at their own prices
Licensed SeatsTotal seats across all active subscriptions
Active SubscriptionsNumber of organizations with active subscriptions
Past DueOrganizations with failed payments
Trial Conversion RatePercentage of trials that convert to paid
Subscription TableList of all subscriptions with status, seats, and organization details

FAQ

What happens if my payment fails?

Stripe may automatically retry the payment over several days. Your organization remains suspended until payment is resolved and Stripe reports a valid subscription state.

Can I get a refund?

Contact your z8 administrator or support for refund requests. Refunds are handled on a case-by-case basis through Stripe.

Do I need billing for self-hosted?

No. Self-hosted z8 deployments can disable billing entirely. All features are available without a subscription when BILLING_ENABLED is not set.

How are seats counted for part-time employees?

Every employee counts as one seat regardless of hours worked or employment type. The only price difference is between full seats and kiosk seats: an employee who only clocks at kiosks and has no sign-in is a kiosk seat.

On this page