This is the documentation for the deprecated product BILLmanager 5. It is no longer updated and may be irrelevant. Documentation for the current version of BILLmanager can be found in the BILLmanager 6 section.
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.
Examplehttps://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=onExtend 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.
Examplehttps://api.ispsystem.com/manager/billmgr?authinfo=user:passwd&out=xml&func=service.prolong&elid=334673&period=1&sok=okChanging 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.
Examplehttps://api.ispsystem.com/manager/billmgr?authinfo=user:passwd&out=xml&func=platform.edit&elid=334673&comment=<new comment>&addon_55165=<new addon value>&sok=okSuspend license
License suspension is set by the function platform.suspend.
Examplehttps://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.
Examplehttps://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.
Examplehttps://api.ispsystem.com/manager/billmgr?authinfo=&out=xml&func=platform.delete&elid=<license id>
En
Es