Product & Billing Cycles
HmSingleOrderAddon displays the products and pricing you configure in WHMCS. This page covers how product settings interact with the order form.
How Products Appear
Products appear in the order form based on the direct URL linking:
https://yourdomain.com/checkout.php?a=add&pid={productId}
The addon reads the product’s configuration from WHMCS and renders:
- Product name and description
- Available billing cycles with prices
- Domain requirement flag
- Configurable options (if any)
Info
The order form does not render a product catalog or product listing. It is designed to display a single product per visit, linked directly from your marketing pages.
Product Configuration in WHMCS
Configure products as normal in WHMCS Admin → Products/Services. The fields that directly affect the order form:
Details Tab
| Field | Effect |
|---|---|
| Name | Shown as the product title |
| Description | Shown below the product name |
| Product Type | Hosting, Other, etc. — shows domain section only for Shared/Reseller/VPS types |
| Hidden | Hidden products cannot be ordered via direct URL |
Pricing Tab
Set up billing cycles and their prices here. The order form displays billing cycle options in the order WHMCS returns them:
| Cycle | Display Label |
|---|---|
| Monthly | Monthly |
| Quarterly | Quarterly |
| Semi-Annually | Semi-Annually |
| Annually | Annually |
| Biennially | Biennially |
| Triennially | Triennially |
Only cycles with a non-zero price are shown. Free cycles (price = 0.00) are also shown with a “Free” label.
Pre-selecting a billing cycle
Use the billingcycle URL parameter to pre-select a specific cycle for your marketing campaigns:
checkout.php?a=add&pid=5&billingcycle=annually
Free Trial
If you enable a free trial on the product, it is shown as the first option in the billing cycle selector.
Upgrades / Downgrades
The order form handles new orders only. Upgrades and downgrades for existing services are handled through the standard WHMCS client area.
Promotional Pricing
If you have active promotions in WHMCS → Promotions, apply them via the promocode URL parameter:
checkout.php?a=add&pid=5&promocode=SUMMER25
The promo discount is applied automatically and shown in the order summary section.
Product Groups
WHMCS product groups are used for organizing products in the WHMCS admin — they do not affect how the single-page order form renders.
Multiple Products Per Order
HmSingleOrderAddon is designed to sell one product per checkout session. For customers who want to order multiple products, they should complete separate checkouts.
Note
Multi-product cart support is on the roadmap for a future version. Subscribe to HostModules product updates to be notified when this is available.