BILLmanager 6

Connect ISPmanager as a storage

Settings in ISPmanager

  1. Create an administrator for integration with BILLmanager. To do so, log in to ISPmanager with the superuser permissions and go to User accountsAdministratorsAdd.
  2. If you use ISPmanager Lite, enable disk quotas. For more information please refer to the article Set disk quotas.
  3. Create a user template. Forbid creating domains, databases, shell access for this template, and limit the number of FTP users the template can create.

Create a processing module

Integration is configured in the process of creating a service processing module in BILLmanager.

To create a service processing module, enter IntegrationProcessing modules → click Add. The processing module adding wizard consists of the following steps:

  1. Product type: select "External FTP-storage".
  2. Processing module: select "ISPmanager".
  3. Configuring integration. Specify the data for integration:
    1. URL — enter the full URL of the control panel where service will be activated.
    2. Username — enter the username (with Admin permissions) in ISPmanager. BILLmanager will use the account to manage client accounts in ISPmanager (create, suspend, delete, etc.).

      Note:
      Use the Admin login and password for integration with ISPmanager Business. Integration cannot be set up with Reseller credentials.
    3. Password — enter the user password.
  4. Parameters of the service processing module. Configure internal (within BILLmanager) parameters of the service processing module:
    1. Data center — select the data center in BILLmanager to which the processing module will be connected.
    2. Name — specify the name of the processing module to be displayed in the BILLmanager interface.
    3. Department — select the department to which tasks from the processing module will be assigned.
    4. Sort — specify the processing module’s priority. If more than one processing module is connected to a tariff plan, the processing module with the lowest priority is selected first when creating the service.

Create a tariff plan

To create a tariff plan in BILLmanager:

  1. Go to ProductsTariff plansAdd.
  2. Select the product type External FTP-storage.
  3. Enter the Name, Processing module, and User template of the ISPmanager user. 
    1. Name — the localized name of the tariff plan. The name is displayed on the service order form and shop-window. 
    2. Processing module  — specify the processing module that you have created for integration. 
    3. Account template — enter the name of the template that will be used for creating a user in ISPmanager. The template defines what and how many resources a client can use. Navigate to ISPmanager → Users Templates

If you specify a non-existing template, ISPmanager will create a new one automatically. The name will be taken from the Account template field. The template allows a customer to use unlimited resources.

One and the same resource may be specified in the account template in ISPmanager and in the tariff plan in BILLmanager. The parameters in the billing system have higher priority. 

Example: the account template "Site hosting" in ISPmanager has the following limits: 25 databases and 25 domain names. In BILLmanager we create tariff plan "Site hosting". ISPmanager uses the template of the "Site hosting" account. The tariff plan has the "Databases" addon which price includes 10 databases. "Domain names" are not configured. 

When the client orders the service related to the "Site hosting" tariff plan, a new account with 10 databases and 25 domain names will be created in ISPmanager. 

Additional settings

Username template is used for generating a username in ISPmanager. You can utilize the following macros in this field: 

  • @USERNAME@ — username of the current account.
  • @DOMAIN@ — service domain name.
  • @ID@ — service unique identifier.
  • @ACCOUNT_ID@ — service owner account id. 

Example: we specified "user@ID@" in the Username template field. The client orders a shared hosting service with the identifier "117". Therefore, the username in ISPmanager will be "user117".