Users, packages, subscriptions & billing

Platform admin

This group covers who can log in, what plans you sell, which orgs are subscribed, and how payments are processed. Full submenu reference: docs/PLATFORM_BILLING.md → “Every menu and submenu explained”.

Users

Users list

Menu path: /admin/users

Search all accounts. Open a user to see organizations and roles.

  1. Platform admin → Users
  2. Open user row
  3. Review organization memberships and super-admin flag

Super admin

Menu path: /admin/users

Grant platform-wide access. First admin is seeded via AdminSeeder (ADMIN_EMAIL in .env).

  • Only super admins see Platform admin menu.
  • Revoke carefully—you may lock yourself out if no backup admin exists.

Packages (menu)

Growth & Plan → Packages — subscription products you sell.

Packages list

Search

Menu path: /admin/packages

Filter by name, slug, or billing interval.

Table columns

Menu path: /admin/packages

Package name, slug, price, interval (monthly/yearly), trial days, Edit link.

Create package

Menu path: /admin/packages/create

Opens the package form for a new plan.

Create / edit package form

  1. Name, slug, description — shown on workspace pricing cards.
  2. Display order (sort_order): 0–99 = public catalog on Plan & billing; 100+ = hidden from owners.
  3. Price, billing interval, trial days.
  4. Module access — which ERP modules the plan unlocks.
  5. Plan highlights — one benefit per line (checkmarks on cards).
  6. Advanced JSON — only if highlights are empty.

Subscriptions (menu)

Growth & Plan → Subscriptions — every org’s subscription row.

Assign subscription

Organization + Package + Status

Menu path: /admin/subscriptions

Manually attach a plan to a customer (active, trial, cancelled, past_due). Click Create.

Subscriptions table

Columns

Menu path: /admin/subscriptions

Organization, package, status (with access warning), renewal date, actions.

Edit

Menu path: /admin/subscriptions

Change status inline → Save.

Renew / Pay · renew

Menu path: /admin/subscriptions

Owner-style renew or open Razorpay checkout.

Mark paid

Menu path: /admin/subscriptions

Manual provider only — record offline payment and extend access.

Paid badge

Menu path: /admin/subscriptions

Subscription paid and granting access — no action needed.

Delete

Menu path: /admin/subscriptions

Remove subscription record (destructive).

Billing (menu)

Growth & Plan → Plan & billing — three tabs: Platform, Payments, Activity.

Tab: Platform

  1. Tenant central domain + workspace URL style (subdomain vs path).
  2. Require admin approval for new organizations.
  3. Tenant DB provisioning: automatic vs manual.
  4. Sync organization subdomains — rebuild domain records.

Tab: Payments

  1. Copy webhook URL into Razorpay dashboard.
  2. Default provider: Razorpay or Manual.
  3. Razorpay keys, currency, redirect URL, webhook secret — Validate keys.
  4. Toggles: Enable UPI, Offer recurring (eMandate).
  5. Save billing settings at page bottom.

Tab: Activity

Simulate webhook

Menu path: /admin/billing

Test payment.succeeded / failed on latest subscription (does not save settings).

Recent payments

Menu path: /admin/billing

Cross-org payment log.

Recent subscriptions

Menu path: /admin/billing

Latest subscription rows and provider ids.

Workspace → Plan & billing (owner)

Owners open Workspace → Plan & billing or the account menu link. Members see view-only.

Tab: Subscription

Billing period card

Next renewal, access end, or trial end — color shows OK / due / ended.

Subscription ended

Plan dropdown + Renew with selected plan; link to Change plan tab.

Your plan

Active plan, price, status, Pay now if needed, Compare plans link.

Tab: Plans / Change plan

Pricing grid

Cards: Get started, Upgrade, Renew this plan, Switch to this plan. Badges: Most popular, Previous plan, Current plan.

Tab: History

Transaction history

Date, plan, amount, status, reference, Download PDF invoice.

Developer reference: docs/PLATFORM_BILLING.md (webhooks, cron, lifecycle, testing).