Reselling ispmanager licenses through BILLmanager

BILLmanager offers automated reselling of ispmanager lite, pro, and host licenses.

Features

Requirements for module resale

To set up the integration, the latest versions of the ispmanager 6 panel and the BILLmanager platform are required.

Creating and configuring a processing module

To configure the integration, start by connecting a processing module in BILLmanager:

1. Log in to BILLmanager with an administrator account at https://YOUR_DOMAIN/billmgr.
2. Go to Integration → Processing modules.
3. On the toolbar, click Add.
4. At the Product type step, select Licenses.
5. At the Processing module step, select BILLmanager.
6. At the Integration settings step, fill in the required fields:
   • URL — the address of the ispmanager billing system that will provide licenses: https://api-eu.ispmanager.com
   • Username — the login of the account used to make purchases in the ispmanager client area.

   • Password — the password of the account used to make purchases in the ispmanager client area.

     If 2FA is enabled for the ispmanager account, BILLmanager will display an error when connecting the processing module. Disable 2FA or use a different account for integration.

7. Click Next.
8. At the Processing module parameters step, specify the data required to create the module:

   • Data center — a set of servers connected from the BILLmanager side.

     How to create a data center

     1. Go to Integration → Data centers.
     2. On the toolbar, click Add.
     3. In the settings, enter the data to create a data center:
        • Name — the name of the data center in the interface for a specific localization.
        • External data center id — the data center service code from a third-party system.
        • Sorting order — priority of the data center among others connected in BILLmanager. Sorting uses natural integers from 1 to N (the lowest number has the highest priority).
     4. Click Ok.
   • Name — the processing module's name in the interface for a specific localization.

   • Department — the department in BILLmanager responsible for tasks assigned by the module. Examples: 'Technical department', 'Sales department', or 'Service processing department'. Tasks will only be visible to the selected department.

     How to create a responsible department

     1. Go to Provider → Departments.
     2. On the toolbar, click Add.
     3. In the settings, enter the data to create the department:
        • Main settings:
          • Name — the department name in the interface for a specific localization.
          • Business hours— department working hours that define its response time. To select a schedule, create one under Provider → Business hours.
          • Show in Support center — check this box to make the department available for clients when submitting a support request. This enables Department settings.
          • Task localization — localization used for task notifications assigned to the department. Additional languages are available if added under Settings → Localizations.
        • Department settings:
          • Available to clients of the selected provider — providers whose clients will see this department when creating a request.
          • Head of department — head of the support department. To select an employee, create one under Provider → Employees.
          • Ticket category description — short description of the department and its responsibilities, shown to clients when selecting a department.
          • Sort — priority of the department among others in BILLmanager. Sorting uses natural integers from 1 to N (the lowest number has the highest priority).
   • Sort — processing module priority among others connected in BILLmanager. The processing module with the lowest priority number is selected for service processing. Use natural integers from 1 to N.
   • Processing module minimal balance — the minimum balance of the processing module required for successful service renewal. An ispmanager account with a positive balance is required. The value is specified in the currency of the ispmanager account balance. The currencies of the selling and reselling platforms must match.
9. Click Finish.

After connecting the module, configure the tariffs in BILLmanager.

Tariffs management

To ensure your clients can order licenses, create, configure, and enable a tariff plan. If necessary, configure period comparison with additional licenses order periods.

Importing a tariff

1. Log in to BILLmanager with an administrator account at https://YOUR_DOMAIN/billmgr.
2. Go to Products → Tariff plans.
3. Click Import on the toolbar.
4. In the settings, select the processing module created earlier.
5. Click Next.
6. Import ispmanager 6 lite , pro and host plans one by one:
   • Product type — select Licenses

   • Tariff plan — select the ispmanager tariff type and its service code:

     For my.ispmanager.comFor eu.ispmanager.com

     • 55231 — tariff code ispmanager 6 lite
     • 55232 — tariff code ispmanager 6 pro
     • 55233 — tariff code ispmanager 6 host

     • 55227 — tariff code ispmanager 6 lite
     • 55228 — tariff code ispmanager 6 pro
     • 55229 — tariff code ispmanager 6 host

   • Provider — select a provider to import the tariff plan. This will allow you to brand your sales services, separate sales of different license types, separate sales by customers, and process payments in different currencies.

     How to create a provider

     1. Go to Provider → Providers.
     2. On the toolbar, click Add.
     3. Enter the details to create a provider:
        • Main settings:
          • Name — name of the provider
          • Upload icon 16x16 — an image that will be used in the list of available providers. Maximum size: 16x16 pixels
          • Email for notifications — the email address from which notifications will be sent to clients. To ensure successful notification sending, set up an external mail server and outgoing email gateway.
          • Support email — the email address from which notifications will be sent: about user activation, payer activation, and password recovery. Leave blank to send notifications from the Email for notifications.
          • Web-site URL — the address of your website
          • Billing URL — a public address with access to BILLmanager
          • Help URL — the address of the page that will be opened for the client from the Help → Help section

          • Currency — the currency used for settling orders with clients of one provider. After creating a provider, you can change the currency. New accounts in the new currency will be created for all clients. Clients who already had an account registered in the old currency will retain their account.

            If there are active payments or uncovered expenses in the system, the currency change will not occur.

          • Default Country — the default country and interface localization
        • Methods of registration and authorization:

          • By phone number — enable phone number authorization. When registering or logging into BILLmanager, you will be asked for a confirmation code via an SMS. If your phone number is not provided or not confirmed, you will need to log in with your username and password.

            • Number of code entry attempts — the limit on the number of times an incorrect code can be entered. Once the limit is reached, a new confirmation code will be required.
            • Number of code retrieval attempts — the limit on the number of times a new confirmation code can be sent to a phone number. Once the limit is reached, a timeout will be required before another authorization attempt can be made.
            For more information on employee registration and authorization methods, please refer to the official ISPsystem documentation.

7. Click Finish.

After importing, three new plans will appear on the list: ispmanager 6 lite, pro, and host. Prices for monthly and yearly periods will be automatically set for these plans. This will allow you to immediately enable these plans and start reselling licenses.

If necessary, fine-tune your plans or enable period matching to add additional periods for ordering licenses.

Configuring a tariff

1. Log in to BILLmanager with an administrator account at https ://YOUR_DOMAIN/ billmgr.
2. Go to Products → Tariff plans.
3. Select and Edit an existing tariff.

4. Set the necessary settings in the blocks:

   Main settings

   • Name — the plan name in the interface with a specific localization. Additional languages are available if added in Settings → Localizations.

   • Internal name — tariff code in ispmanager:

     For my.ispmanager .comFor eu.ispmanager.com

     • 55231-ispmgr5 — tariff code ispmanager 6 lite
     • 55232-ispmgr5 — tariff code ispmanager 6 pro
     • 55233-ispmgr5 — tariff code ispmanager 6 host

     • 55227-ispmgr5 — tariff code ispmanager 6 lite
     • 55228-ispmgr5 — tariff code ispmanager 6 pro
     • 55229-ispmgr5 — tariff code ispmanager 6 host
   • Charge daily — charges the license fee daily. If enabled, the following options are available:

     • Calculate daily cost depending on order period — the daily charge amount will not depend on the number of days in the month. The daily cost will be calculated based on the number of days in the order period.

       Example

       In January, a client orders a monthly license. The daily charge is $0.1. Without this option, the charge will be $3.1 for 31 days of the month. With this option, the cost will be calculated based on the number of days in the license period (30 days). Thus, the client will pay $3 for 30 days of license use.

     • Allow clients to resume/suspend services — the client will have the right to enable and disable the license.
     • Charge client after suspension — if enabled, the client pays for the license's downtime. If disabled, the client will be refunded for the license's downtime. Available when using the Calculate daily cost depending on order period and Allow clients to resume/suspend services options.
   • Calendar-based charges — the service term will be aligned with the calendar month. Not available when using the Charge daily option.

     • Pro-rata day — If a customer orders a license on the day of the month before the transition day, the service term will be calculated until the end of the current month. If a license is ordered on the transition day or later, the service term will be calculated until the end of the following month. The order or renewal price will be adjusted accordingly. Default value: 15. Available when using the Calendar-based charges option.

       Example

       The Pro-rata day is set to 15. The license the client ordered on July 12 will be active until August 1. The license the client ordered on July 17 will be active until September 1.

   • Quick order — order a license without specifying parameters. Allows you to defer configuration until you order the license.
   • Service activation notification template — a notification template with instructions on how to use the license. The notification is sent to the client via email after the license is activated and is also repeated in BILLmanager. Available if the template has been previously added in Settings → Message templates.
   • License agreement — a license agreement template that the client must agree to when ordering a license. Available if a template has been added in Settings → Document templates.
   Additional settings

   5th version — administrators will be able to manually change the license key for active licenses. This can be done in the specific license settings under Licenses → Licenses. Enabled by default.

   Prices

   • One month — the cost of the license or its renewal for a month.
   • Disable the "Monthly" period — check this box if you want to prohibit ordering a license for a month.
   • Three months — the cost of the license or its renewal for three months.
   • One year — the cost of the license or its renewal for a year.
   • Disable the "Yearly" period —  check this box if you want to prohibit ordering a license for a year.
   • For three years — the cost of the license or its renewal  for three years.
   • Setup fee — additional charge when purchasing a license.
   • Renewal with special price — a separate price for renewing your license for a selected period. If you check this box, the following options are available:
     • Renew for 1 month — the cost of renewing a license for a month
     • Renew for 3 months — the cost of renewing a license for three months
     • Renew for 1 year — the cost of renewing a license for one year
     • Renew for 3 years — the cost of renewing a license for three years
   Policy

   • Allow for client groups — customer groups that can order and change tariffs.

     How to create a client group

     1. Go to Clients → Client Groups .
     2. On the toolbar, click Add.
     3. Set the required settings:
        • Name — name of the client group
        • Allow service suspension/activation — check this box to allow group clients to activate and suspend licenses.
        • Allow service deletion — check the box to allow clients in the group to remove licenses.
        • Ignore the number of services on client's account — check the box to override the policy for the Number of services available for order in the tariff settings.
     4. Click Ok.
   • Forbid to client groups — groups of customers who cannot order or change their tariffs.
   • Minimum order period — the minimum license usage period after ordering. If this option is set, the following is available:
     • Minimum period length — the number of days or months in the minimum order period.
   • Trial period — the number of free days to use the license. Leave blank if the plan does not have a trial period.
   • Number of trials available for order — the maximum number of trial copies of the tariff plan services.
   • Number of services available for order — the number of licenses available for order per client. If a client reaches the limit, ordering licenses for this plan will be unavailable.
   • Simultaneous services order — the client can add multiple services to the cart simultaneously. If you check this box, the following option will be available:
     • Maximum number of services — the number of services added to the cart simultaneously. Large numbers of services ordered simultaneously may impact BILLmanager performance .
   • Late renewal fee — a penalty for late license renewal. The penalty is charged when the client renews the license. Available values:
     • Without fee — late renewal of a license is not subject to a penalty
     • Fixed amount — a fixed penalty amount is added to the renewal cost

     • Percent from the price for late renewal — a percentage of the cost of the overdue period is added to the cost of the renewal

       Example

       A 50% fine is imposed for late renewal of a license.

       The license expired on September 1, and renewal is scheduled for September 5. 
       To calculate the fine, the system will calculate the service cost for each day (even if the license was purchased for a year). Let's say the fine is $0.1 per day. The late fee will then be calculated:

       5 days x $0.1 = $0.5

       The total fine amount is $0.25, since the fine percentage is 50%.

     • Renew from suspension date — the service term will be calculated from the date of suspension, not the renewal date. This means the penalty is calculated based on the service term, not the monetary amount.

       Example

       The license expired on August 3, and renewal is only available on August 15. After renewal, the license will be activated until September 3, not September 15.

   • Auto-deletion period — the number of days set for the automatic deletion of unrenewed licenses. Leave blank to use the auto-deletion period specified in the Service type settings (License). If the auto-deletion period is not specified in the service type, expired services will not be deleted.
   • Suspend service on weekends — overrides the license shutdown policy. Available values:
     • Use product type settings — the tariff will use the policies from the settings of the corresponding product type.
     • Suspend services — tariff services will be stopped on weekends (Saturday, Sunday) if the client does not have a sufficient account balance to pay for the extension
     • Do not suspend services — services under this plan will not be suspended on weekends (Saturday, Sunday) if client does not have a sufficient account balance to renew them. If there is a penalty for renewing a suspended service, funds for the additional days of service will be debited from the customer's account when paying for the service renewal.
   • Tariff change policy — the billing policy used when changing a service's tariff. Available values:
     • Change period — when changing the tariff, the validity period of the service will be recalculated upwards when switching to a cheaper tariff, or downwards when switching to a more expensive tariff
     • Add funds/refund — when upgrading to a more expensive tariff, the customer will be required to pay the difference in price for the remaining service period. When downgrading to a cheaper tariff, the customer will be refunded the difference in price for the remaining service period.
     • Tariff cannot be changed — switching to another tariff will be impossible
     • Extra charge only, no refund upon downgrade — when switching to a higher plan, the customer will need to pay the difference in price for the remaining service period. When switching to a lower tariff, there will be no refund, but the customer will be able to use the previous plan without any additional payment.
     • Full payment for a new tariff plan — the client will be charged the full cost of the new plan, and the service validity period will be calculated based on the selected order period from the date of the plan change.
       • Renew from — the service renewal policy for a new tariff plan. Available values:
         • current date — the service is extended from the current date.
         • service expiration date — the service is extended from the expiration date.
   • Additional resources order policy — a method for calculating the cost of additional resources when ordering a license during its validity period. To use this option, create and configure additional resources. Available values:

     • Price before a service expiration date — the cost of add-ons is calculated until the license expiration date

       Example

       The license is valid until November 30. Additional license resources must be ordered on November 15. The cost of these add-ons will be calculated for 15 days only.

     • Full price over the whole period — the full cost of add-ons, regardless of the license expiration date. The most recently paid or renewed license period is selected for the add-on.

       Examples

       Example 1:

       Additional resources are being ordered for the license on November 10. Previously, the license was purchased for a month until November 20. The add-ons will only be active for 10 days, but will be paid for at full price.

       Example 2:

       A customer used the service for three months, renewing it each time for a month. Seeing that the service was about to expire again, the customer renewed the service for another three months. After using the service for two months, they decided to order additional resources. If the Full price over the whole period option is used, the cost of the add-ons will be charged for three months. Even if there's one month left on the service, this will not affect the cost of the add-ons.

   • Addon cancellation policy — cancellation of tariff plan add-ons. A refund for the remaining license term or license removal without compensation is possible.
   • Tariff plan end date — date after which it is impossible to order or renew the tariff.
   • Notes — here you can add text notes about the plan. Visible only to company employees.
   Service order configuration

   • Sort — sorts tariffs from the list by priority. The tariff with the lowest priority is selected for processing. Natural integers from 1 to N are used. If tariff values are the same, they are sorted alphabetically.
   • Upload icon — an image for a specific tariff in the BILLmanager interface .
   • Show addon icons — the rule for displaying icons for add-ons to the tariff plan.
   • Tariff description — a plan description in the BILLmanager interface linked to the active localization. Markdown markup is available .
   • Information for site — internal information required for integrating BILLmanager with your website. This information is only visible in the plan settings.
   • Labels — a list of values required for customers to filter tariffs. Each value is specified in a new line.
5. Click Ok.

Once all settings are configured, enable the tariff.

Enabling a tariff

To enable customers to order ispmanager licenses, enable imported plans:

1. Log in to BILLmanager with an administrator account at https://YOUR_DOMAIN/billmgr.
2. Go to Products → Tariff Plans .
3. In the list, click on the imported tariff.
4. Click Enable on the toolbar.
5. Confirm the activation of the tariff.

Repeat the steps to enable all ispmanager 6 lite, pro, and host plans.

Period comparison

After activating a tariff plan, the administrator can adjust additional order periods that aren't available in BILLmanager. If comparison isn't configured, selecting an additional period when ordering a license will result in an error.

To set up period comparison:

1. Log in to BILLmanager with an administrator account at https://YOUR_DOMAIN/billmgr.
2. Go to Integration → Processing modules.
3. Select the required module from the list.
4. On the toolbar, click Parameters.
5. Add and configure periods comparison:
   • Parameter — select Periods comparison

   • Source period — select the period you want to replace. For example, for the ispmanager 6 lite plan, the initial period is Month.

     Available period options

     • Trial period — free trial period
     • Day
     • Month
     • Three months
     • Half a year
     • Year
     • Two years
     • Three years
     • Four years
     • Five years
     • Ten years
     • Lifetime

   • Change into — select a new period to replace the source period when processing the order.

     Available period options

     • Trial period — free trial period
     • Day
     • Month
     • Three months
     • Half a year
     • Year
     • Two years
     • Three years
     • Four years
     • Five years
     • Ten years
     • Lifetime
   • Compare with tariff plan — check this box to enable period comparison when ordering a license for the specified tariff
     • Product type — select Licenses

     • Tariff plan — select the tariff for which period comparison will work

       Only enabled tariffs are displayed in the list.

6. Click Ok.

Selling licenses as part of a virtual server

In BILLmanager, ispmanager licenses can be sold either as standalone services or as part of a virtual server.

Configuring the VMmanager processing module

To resell ispmanager licenses as part of a virtual server, use two processing modules:

• one as a license server
• the other with VMmanager 6 integration

If a processing module with VMmanager 6 integration already exists, ensure that the ispmanager license server is selected as the license server. If there is no processing module with VMmanager 6 integration, create one.

Creating enumeration items for tariffs

1. Log in to BILLmanager as an administrator at https://YOUR_DOMAIN/billmgr.
2. Go to Products → Enumerations.

3. Create and open the enumeration Server control panel.

   How to create enumerations

   

   1. Go to Products → Enumerations.
   2. On the toolbar, click Add.
   3. Enter the enumeration creation details:
      • Name — specify Server control panel
      • Internal name — specify panel as the internal enumeration code for ispmanager
   4. Click Ok.
4. Click Values on the toolbar.
5. Sequentially create enumeration items for ispmanager 6 lite, pro, and host plans:
   • Name — tariff name displayed in the interface for a specific localization. Additional languages are available if added under Settings → Localizations.
   • Internal name — service code for the ispmanager tariff.
6. Click Ok.

Configuring the virtual server tariff

1. Log in to BILLmanager as an administrator at https://YOUR_DOMAIN/billmgr.
2. Go to Products → Tariff plans.
3. Select the desired virtual server tariff and click Options on the toolbar. If the virtual server tariff does not exist yet, create it.

4. Enable Control panel license and set the pricing. If the item does not exist, create it.

   How to create an additional resource for a license

   1. On the toolbar, click Add.
   2. In the resource settings, specify the following information:
      • Main settings:
        • Billling type — select Based on order
        • Type — select Control panel license
        • Value type — select Enumeration
        • Edit resource after order — allows the client to modify the resource after it was ordered. For example, ordering additional disk space or refusing excess RAM. Available values:
          • Can be modified — the client can order additional resources or partially cancel the ordered resources (if the minimum order period condition is met)
          • Cannot be modified — after payment for the order, the client will not be able to modify the ordered resource
          • Only upgrade — the client can only add extra resources
          • Only downgrade — the client can only partially cancel the ordered resources (if the minimum order period condition is met)
        • Minimum order period — a minimum period of time (day or month) that will pass after ordering before the client will be able to cancel some of the resources

          • Period — a minimum order period

            Example

            Minimum order period is set to Day. Period is set to 5. In this way the client will be able to cancel excess RAM after 5 days.

        • Manual setup — a task will be created for the technical department to process the resource order
          • Skip default values — if Default value is selected, a separate task will not be created for the technical department
        • Custom Name — a new alternative name for the resource
          • Name — the resource name in the interface for a specific localization
        • Internal name — specify as panel
      • Statistics settings:
        • Bill on suspended service — service will be charged even if it is inactive

        • Sum up invoices — when generating an invoice, the total resource value for the entire period will be indicated

          Example

          The client ordered 100 GiB of additional traffic for 5 months. The resources were only used for 3 months. When generating an invoice, 500 GiB of additional traffic will be indicated for 5 months.

      • Tariff limits:
        • Enumeration— select Server control panel
        • Default value — the enumeration item included by default when ordering a service
        • Price after change — the rules for calculating the cost of changing the resource value. Applies if the condition is set in the additional resource ordering policy of the tariff plan. Available values:
          • difference in prices — the difference between the current and new value will be debited, or funds equal to the difference in value will be refunded to the account
          • full price — the client will be charged the full cost of the new value or proportionally over the service term
      • Service order configuration:
        • Sorting (in direct order) — prioritizes the resource among others connected in BILLmanager
        • Hide on the tariff card — the resource will not appear in order lists
        • Upload icon — an image for a specific resource in the BILLmanager interface
        • Add-on description — a description of the resource in the BILLmanager interface linked to the active localization. Markdown markup is available
   3. Click Ok.

Test order

To verify that ispmanager 6 lite, pro, and host tariffs are available to clients and that orders are processed correctly, perform a test order:

1. Log in to BILLmanager as an administrator at https://YOUR_DOMAIN/billmgr.

2. If you do not have a test client account in BILLmanager, create one.

   How to create a client account in BILLmanager

   1. Follow the billing URL specified in the provider settings.
   2. On the authorization form, click Register.
   3. In the registration form, enter the following details:
      • Name — client’s full name
      • Email address — login for client authorization in BILLmanager
      • Password — password for client authorization in BILLmanager
      • Re-enter the password — client password confirmation
      • Country — client’s country of registration in BILLmanager
   4. Click Register.

3. Proceed to the client area.

   How to access the client area in BILLmanager

   1. Go to Clients → Clients.
   2. In the list, select the previously created client.

   3. On the toolbar, click Log in.

      

   You will be automatically redirected to the client area.

4. In the client area, order a license.

   How to order a license in BILLmanager

   1. Go to Licenses → Licenses.
   2. On the toolbar, click Order.
   3. Specify the order period and click Select.
   4. In the License section, click Order.
   5. Enter the license registration details:
      • License name — the license name displayed in the BILLmanager interface
      • IP Address — server address required for automatic license activation
   6. Confirm the selected billing period.
   7. Enable Auto-renewal for the paid service if necessary.

   8. Click Enable or Pay.

      Details

      • Enable — available when ordering a free service.
      • Pay — available when ordering a paid service.

   9. Select and set up the required payment method. Additional payer data verification may be required (for legal entities).

      Payer data verification

      • Recipient — company receiving the payment.
      • Bank name — bank receiving the payment.
      • BIC — bank identification code.
      • Checking account — settlement account number.
      • Correspondent account — correspondent account number.

      A payer can be created separately or during the license order in Client → Payers.

   10. Review the order details and complete the payment.
5. If successful, a notification will appear: The service is ready for use. To view and manage the license, go to Licenses → Licenses (available to both clients and administrators).
6. The license status will automatically change to Processing (opening). Wait for BILLmanager confirmation for the status to change to Active.

7. If necessary, delete the test order.

   How to delete a test order in BILLmanager

   1. In the BILLmanager navigation area, go to Licenses → Licenses.
   2. Select the previously created license.

   3. On the toolbar, click Delete.

      

   4. Confirm license deletion.