What Is a Service?
A service is a provisioned product for a specific client. Services are created automatically when an order is paid and approved. Each service represents one active subscription or one-time delivery.
Service Fields
| Field | Description |
|---|---|
| Client | The account the service belongs to |
| Product | The product that was ordered |
| Server | The server the account is hosted on (hosting type only) |
| Domain | Domain name associated with the service |
| Billing Cycle | The cycle selected at order time |
| Next Due Date | Date the next renewal invoice will be generated |
| Amount | Recurring amount charged on each renewal |
| Status | Current state: pending, active, suspended, terminated, cancelled |
| Options JSON | Configurable options selected at order time |
| Username / Password | Provisioned credentials (hosting type) |
Where to View Services
- Admin: Admin → Services — lists all services across all clients, with filters for status, product, server, and client.
- Client area: Client Area → My Services — lists the logged-in client's own services.
Service Creation Flow
Order paid + approved
│
▼
Service created (status: pending)
│
Product type?
/ \
Hosting Other
│ │
Provisioning Admin sets
job runs active manually
│
Success?
/ \
Yes No
│ │
active stays pending
(admin notified)
Recurring Billing
Commerce auto-generates renewal invoices before the next_due_date (based on the Invoice Generation Days setting). On payment of the renewal invoice, next_due_date advances by one billing cycle.
If a renewal invoice is not paid by the due date, the service enters a grace period. After the grace period expires, it is suspended automatically.
Service History
All status changes on a service are recorded in the activity log with timestamp, actor (system/admin/client), and reason. View the log on the service detail page at Admin → Services → [service] → Activity Log.
Admin Services List
The admin services list at /admin/services shows:
- Client name (linked to client profile)
- Product name
- Domain
- Next due date
- Status (colour-coded)
- Server
Filter by status, product, server, or search by domain/client. Bulk actions available: suspend, unsuspend, terminate.