Selling ispmanager modules through BILLmanager

BILLmanager offers automated reselling of modules in ispmanager.

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 service handler

To set up the integration, start by connecting the processing module in BILLmanager:

1. Log in to BILLmanager as an administrator at https://YOUR_DOMAIN/billmgr.
2. Go to Integration → Processing modules.
3. On the toolbar, click Add.
4. At the Product type step, select ISPsystem modules
5. At the Processing module step, select BILLmanager.
6. At the Integration settings step, enter the following data:
   1. URL ispmanager — the address of the ispmanager billing system, which will provide licenses for modules: https://api-eu.ispmanager.com
   2. Username — the login of the account under which purchases will be made in the ispmanager client area

   3. Password — the password of the account under which purchases will be made in the ispmanager client area

      If 2FA is enabled in your ispmanager client area, an error will be displayed in BILLmanager when connecting the the processing module. Disable 2FA or use a different account for integration.

7. Click Next.
8. At the Processing module parameters step, specify the details:

   • 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 center details:
        • Name — data center name displayed in the interface for a specific localization
        • External data center id — 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 — name of the processing module displayed in the interface for a specific localization

   • Department — department in BILLmanager processing module tasks will be assigned to. Example: “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 following department details:
        • Main settings:
          • Name — department name displayed 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).
   • Sorting — the priority of the processing module among others connected to BILLmanager. Sorting uses natural integers from 1 to N (the lowest number has the highest priority).
   • Processing module minimal balance — the minimum balance of the processing module required for successful service renewal. A topped-up ispmanager account balance is required. Values ​​are specified in the currency of the ispmanager account. This means the currencies must be the same for both the selling and reselling platforms.
9. Click Finish.

After creating the processing module (license server for modules), import BILLmanager tariffs.

Tariff management

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

Importing a tariff

1. Log in to BILLmanager as an administrator at https://YOUR_DOMAIN/billmgr.
2. Go to Products → Tariff plans.
3. On the toolbar, click Import.
4. In the settings, select the processing module created earlier.
5. Click Next.
6. Import the required tariff plans:
   • Product type — select ISPsystem modules.
   • Tariff plans — tariff ID of the ispmanager paid module

   • Provider — select a provider to import your tariff plan. This will allow you to brand your sales services, separate certificate sales, separate clients, 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 the import, a new plan will appear on the list. Its price will automatically be set for the "monthly" period, which allows to immediately enable the tariff and begin reselling modules.

If necessary, fine-tune all imported tariff plans or enable period comparison to add other periods for ordering modules.

Configuring a tariff

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

4. Set the necessary settings in the following 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 — an automatically set module service code
   • Charge daily — daily charges for sertificate use. 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 service. 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 service period (30 days). Thus, the client will pay $3 for 30 days of service use.

   • Allow clients to resume/suspend services — the client will have the right to enable and disable the ordered module. Not set by default.
     • Charge client after suspension — if enabled, the client pays for the module's downtime. If disabled, the client will be refunded for the module's downtime. Not set by default. Not set by default.
   • 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 service 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 service 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.

       Example

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

   Additional settings

   • Module type — an automatically set internal code of the imported module
   Prices

   To create a tariff plan, you must set a price for at least one payment period.

   • One month — the cost of the module or its renewal for a month.
   • Disable the "Monthly" period — check this box if you want to prohibit ordering module for a month.
   • Setup fee — additional charge when purchasing module.
   • Renewal with special price — a separate price for renewing your module for a selected period. If you check this box, the following option is available:
     • Renew for 1 month — the cost of renewing module for a month
   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 module.
        • Allow service deletion — check the box to allow clients in the group to remove module.
        • 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 module 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.
   • Number of services available for order — the number of modules available for order per client. If a client reaches the limit, ordering modules for this tariff 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 module renewal. The penalty is charged when the client renews the module. Available values:
     • Without fee — late renewal of a module 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 module.

       The module 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 module 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 module expired on August 3, and renewal is only available on August 15. After renewal, the module will be activated until September 3, not September 15.

   • Auto-deletion period — the number of days set for the automatic deletion of unrenewed modules. Leave blank to use the auto-deletion period specified in the Service type settings (ISPsystem modules). If the auto-deletion period is not specified in the service type, expired services will not be deleted.
   • Suspend service on weekends — overrides the service 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 module during its validity period. To use this option, create and configure additional resources in the Products → Tariff plans section → select a tariff plan → Config. Available values:

     • Price before a service expiration date — the cost of addons is calculated until the module expiration date

       Example

       The module is valid until November 30. Additional module resources must be ordered on November 15. The cost of these addons will be calculated for 15 days only.

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

       Examples

       Example 1:

       Additional resources are being ordered for the module on November 10. Previously, the module 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 module term or service removal without compensation is possible.
   • Notes — here you can add text notes about the tariff plan. Visible only to company employees.
   Service order configuration

   • Sort — sorts tariffs from the list by priority. Sorting uses natural integers from 1 to N (the lowest number has the highest priority). 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.
   • Labels — a list of values required for customers to filter tariffs. Each value is specified in a new line.
5. Click Ok.

Enable tariff plans after configuration.

Enabling a tariff

1. Log in to BILLmanager as an administrator at https://YOUR_DOMAIN/billmgr.
2. Go to Products → Tariff plans.
3. Select an imported tariff plan from the list.
4. Click Enable on the toolbar.
5. Confirm enabling of the tariff.

If necessary, repeat for all created tariff 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 module 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 Period 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 ISPsystem modules

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

       Only enabled tariffs are displayed in the list.

6. 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 module.

   How to order a module in BILLmanager

   1. Go to Licenses → Modules.
   2. On the toolbar, click Order.
   3. Select the module and Order it.
   4. Enter the module registration details:
      • License — the ispmanager license ID displayed in the BILLmanager interface
   5. Confirm the selected billing period.
   6. Enable Auto-renewal for tje paid service if necessary.

   7. Click Enable or Pay.

      Details

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

   8. 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 module order in Client → Payers.

   9. 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 module, go to Licenses → Modules (available to both clients and administrators).
6. The module 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 → Modules.
   2. Select the previously created module.
   3. On the toolbar, click Delete.
   4. Confirm module deletion.