Packages
Packages are the core of what you sell to clients. A Package defines a specific product, complete with pricing, stock limitations, scaling options, and the Provisioning Plugin that will run when a client purchases it. In other platforms, these are usually referred to as Products or Services.
Every Package must be connected to one Catalog.
Creating a New Package
When you create or edit a Package, there are several key tabs you must configure: Summary, Pricing, Provisioning Plugin, and Scaling.
Summary Tab
| Field | Description |
|---|---|
| Catalog | Select the catalog to which this package belongs. |
| Name | Enter the name of the product package. |
| Slug | Enter a unique URL-friendly identifier for this package. It will be used in product URLs. |
| Description | Provide a brief description of the package. HTML element supported. |
| Icon | Choose an icon file to represent the package. |
| Stock | Enter the total available stock for this package. Use -1 for unlimited stock. |
| Per User Limit | Set the maximum number of this package a single user can purchase. Use -1 for no limit. |
| Allow Cancellation | Enable to let customers request service cancellation for this package. |
| Allow Quantity | Enable to let customers purchase multiple or single quantities of this package. |
| Prorata Billing Day | Set a specific day of the month (1–28) to enable prorata billing for this package. Leave empty to disable prorata billing. |
| Charge Next Month | Set a specific day of the month (1–28) as the threshold. If a client orders on or after this day, their initial invoice will include the prorata amount plus the full cycle for the next month. Leave empty to only charge the prorata amount. |
| Auto Provisioning | Enable to automatically run provisioning and activate the service upon invoice payment. If disabled, admins must manually trigger provisioning. |
| Status | Set the status of the package to visible or hidden. |
Pricing Tab
Billmora supports various pricing structures per package.
| Field | Description |
|---|---|
| Name | Enter the name for this pricing option (e.g., "Monthly", "Annual"). |
| Type | Select the type of pricing for this package (free, onetime, recurring). |
| Time Interval & Billing Period | Choose the billing interval and period (how often the customer will be billed) for this pricing option. |
| Currency Code | Displays the currency used for this price. This value cannot be changed here. |
| Price | Set the price for this package in the selected currency. |
| Setup Fee | Enter any one-time setup fee for this pricing option. |
| Enabled? | Enable or disable this pricing option without deleting it. |
WARNING
Important Relationship: Price Name Matching
If your Package has customizable options (Variants), the system requires the Name of the Variant Price to exactly match the Name of the Package Price. If you rename a Package Price, you must also rename the corresponding Variant Prices, otherwise clients will not be able to purchase those variants.
Provisioning Plugin Tab
This is where you connect the product to your server automation.
| Field | Description |
|---|---|
| Provisioning Plugin Instance | Select the Provisioning Plugin instance to link with this package. Once selected, you'll be able to configure specific schema options required by the Provisioning Plugin. |
Scaling Tab
If you want to allow clients to upgrade or downgrade their service, you configure that here.
| Field | Description |
|---|---|
| Scalable To | Select the packages that this package can be scaled up or down to. |
Custom Fields Tab
Custom Fields allow you to collect additional information from customers during checkout. These fields are directly tied to the package and will be attached to the service.
| Field | Description |
|---|---|
| Label | The display name for the field shown to the user during checkout. |
| Internal Name | The internal variable name used for mapping. Leave empty to auto-generate from label. Must be lowercase alphanumeric with underscores (e.g., server_hostname). |
| Type | The input type (Text, Password, Textarea, Email, Number, Dropdown). |
| Helper Text | Optional text displayed below the field to guide the user. |
| Default Value | Optional default value to pre-fill the field. |
| Show on Order Form | Toggle whether this field is visible to customers during the checkout process. If disabled, the field can only be populated programmatically or by admins. |
| Show on Invoice | Toggle whether this field and its value are displayed on the customer's invoice. |
| Options | If Type is Dropdown, define the options one per line. Separate the value and label with a pipe (|). If no pipe is used, the value is also used as the label. |
| Condition | Optionally configure conditional logic to show/hide this field based on the value of another package field or additional configuration. |
Connecting Variants
If your Package has customizable options (e.g., clients can choose an operating system when ordering a VPS), you need to set up Variants. Learn more in the Variants guide.