BILLmanager 5 Documentation

Reselling of v6 ISPsystem's licenses via API

Services can be resold by means of remote calls via API. This article describes how to use API to sell ISPsystem’s licenses.

API address of ISPsystem's billing system: https://api.ispmanager.com

Authorization in the system is performed with the parameter authinfo, which assumes the value: authinfo=user:passwd. Where user is the username in https://eu.ispmanager.com, billing system, and passwd is the user password. 

Order a license

To order a license, use the function platform.order.param. Available parameters: 

  • skipbasket — write off the amount and enable immediately, ignoring the cart. Possible values: 
    • on — enable without redirecting to cart; 
    • off — enable with redirecting to cart. Default value, may be omitted from the query; 
  • comment — can be set
  • period — license payment period. Possible values:
    • period=1 — 1 month; 
    • period=12 — 1 year; 
    • period=-100 — trial period;
  • autoprolong — license autoprolongation parameter. Possible values:
    • autoprolong=1 — autoprolongation for 1 month will be charged at license order;
    • autoprolong=12 — autoprolongation for 1 year;
    • autoprolong=null — without autoprolongation;
  • pricelist — tariff plan code. Possible values:
    • pricelist=55163 — VMmanager 6; 
    • pricelist=55161 — DCImanager 6;
  • addon_id — license addon code. The set of addons is different for each license: 
    • addon_55165=N — number of cluster nodes available for connection to VMmanager 6; 
    • addon_55164=N — number of virtual machines available to create in VMmanager 6.
    Example
    https://api.ispsystem.com/manager/billmgr?authinfo=user:passwd&out=xml&func=platform.order.param&clicked_button=finish&period=1&pricelist=55163&addon_55165=1&autoprolong=1&sok=ok&skipbasket=on

    Extend license

    To extend the license, use the function service.prolong with the following parameters:

    • elid — code of the license to be prolonged;
    • period — prolongation period. Possible values:
      • period=1 — 1 month;
      • period=12 — 1 year.
      Example
      https://api.ispsystem.com/manager/billmgr?authinfo=user:passwd&out=xml&func=service.prolong&elid=334673&period=1&sok=ok

      Changing license parameters

      Using the function platform.edit you can change the comment and values of the supplement to the license. New comment is passed by the comment parameter, padding values — addon_id. 

      Example
      https://api.ispsystem.com/manager/billmgr?authinfo=user:passwd&out=xml&func=platform.edit&elid=334673&comment=<new comment>&addon_55165=<new addon value>&sok=ok

      Suspend license

      License suspension is set by the function platform.suspend

      Example
      https://api.ispsystem.com/manager/billmgr?authinfo=user:passwd&out=xml&func=platform.suspend&elid=<license id>

      Resume license

      License resuming is set by the function platform.resume.

      Example
      https://api.ispsystem.com/manager/billmgr?authinfo=user:passwd&out=xml&func=platform.resume&elid=<license id>

      Delete license

      To delete the license, use the function platform.delete.

      Example
      https://api.ispsystem.com/manager/billmgr?authinfo=&out=xml&func=platform.delete&elid=<license id>