Billing & Subscriptions
The 计费 page (/billing) lets tenant admins manage their subscription, view usage, and change plans.
Current Plan 概述
At the top, you'll see:
- Current plan name and price
- 计费 cycle (monthly/annual)
- Next billing date
- Payment gateway (Stripe/PayPal)
Usage Meter
Visual bars showing your current usage vs. plan limits:
| Metric | 示例 |
|---|---|
| 产品 | 3 of 5 used (60%) |
| 活动 | 2 of 10 used (20%) |
| 提交 this month | 247 of 500 used (49%) |
| 团队成员 | 2 of 3 used (67%) |
When usage exceeds 90%, a warning is displayed and an email alert is sent.
Changing Plans
Plan changes use neutral "Change to [Plan]" labeling rather than "upgrade" or "downgrade" terminology.
- Click Change Plan
- Select the desired plan
- Choose monthly or annual billing
- If both Stripe and PayPal are configured, select your preferred payment gateway
- Complete payment
When switching to a higher plan, new features are available immediately. When switching to a lower plan, a prorated credit note is generated and the change takes effect at the end of the current billing period. 功能 above the new plan's limits become unavailable after the switch.
A new invoice is generated for every plan change. See Invoice Management below for details.
Cancelling
- Click Cancel Subscription
- Confirm the cancellation
- Your plan remains active until the end of the current billing period
- After expiry, your account becomes "restricted"
Payment Methods
| Gateway | 工作原理 |
|---|---|
| Stripe | Redirects to Stripe Checkout. Supports credit/debit cards. |
| PayPal | Redirects to PayPal. Supports PayPal balance, linked cards/bank. |
Which gateways are available depends on what the platform owner (superadmin) has configured.
Invoice Management
Tenants can view all their invoices at /billing/invoices. Each invoice displays the following details:
| Column | 说明 |
|---|---|
| Invoice Number | Unique identifier for the invoice |
| Amount | Total amount due or paid |
| Tax | Applicable tax amount (see Tax/VAT below) |
| 状态 | pending, paid, or void |
Pending invoices display a "Pay Now" button. When both Stripe and PayPal are configured by the platform admin, a gateway dropdown appears so the tenant can choose which gateway to pay with before clicking Pay Now.
Tax/VAT
Invoices automatically include applicable tax based on tax rates configured by the platform admin. Tax line items appear on invoice PDFs as separate entries, showing the tax rate and calculated amount.
Subscription Pause
Tenants can pause their subscription at /billing/pause.
- Click Pause Subscription
- Select a resume date (up to 90 days in the future)
- Confirm the pause
While paused:
- The account is placed in a restricted state
- Access to plan features is limited
Subscriptions automatically resume on the selected date via a scheduled command. Tenants can also manually resume their subscription early from the billing page by clicking Resume Subscription.
Gateway Choice
When both Stripe and PayPal are configured by the platform admin, the billing page displays radio buttons allowing tenants to select their preferred payment gateway before initiating any payment action (new subscription, plan change, or invoice payment).
Coupon/Promo Codes
Tenants can apply a promotional code on the billing page to receive a discount on their subscription.
Applying a Coupon
- 导航到 the billing page
- Enter the promo code in the coupon input field
- Click Apply
Once applied, a banner is displayed showing the coupon code name, a description of the discount (e.g., "50% off for 3 months"), and the number of months remaining on the promotion.
Discounted Pricing
Plan cards display the original price crossed out alongside the discounted price so tenants can see exactly how much they save.
Removing a Coupon
Click the Remove button on the coupon banner to remove the applied discount. Pricing reverts to the standard plan rates.
Invoices
All discounts from applied coupons are reflected in generated invoices, showing the original amount, discount, and final total.
Free Trial
New tenants start with a free trial (default: 14 days). During the trial:
- All features are available (with trial limits)
- No payment required
- A countdown shows days remaining
- When the trial ends, the account is restricted until a plan is chosen
下一步
- Branding & 设置
- Subscription Plans (for superadmins)