Reselling ispmanager licenses via API

Automating the resale of ispmanager licenses via API allows for flexible sales and customer service management, as well as adapting the process to your needs and business strategy.

Resale mechanics

License selection and order. When accessing the partner's billing account, end customers see the prices for the licenses set by the partner. They select the desired license and click the Buy button.
License order in the ispmanager client area. The partner then processes the end customer's order and purchases the license in the ispmanager personal account. This can be automated via the API or purchased manually.
Updating license information in partner billing. After the order is successfully processed, the partner billing system receives information about the purchased license. This ensures the correct activation and use of the license by the end customer.
License activation and management. The end customer activates the license on the server and manages it through their personal account in the partner billing system.

Step 1. Configuring partner billing

To allow customers to renew their ispmanager license and change its plan from the control panel, implement GET requests for license renewals and plan changes in your partner billing.

Example of a license renewal request:

https://api.PARTNER_BILLING.com/?action=prolong&query=startform%3Dservice.prolong%26utm_source%3Dispmanager_panel%26elid%3D8898549%26utm%5Fsource%3Dispmanager%5Fpanel&license=8898549&ip=37%2E230%2E114%2E96&utm_source=ispmanager_panel

Details

action — the type of action called: prolong — renewal
license — license ID
ip — primary IP address on the server running ispmanager

Example of a request to change the license plan:

https://api.PARTNER_BILLING.com/?action=changepricelist&query=startform%3Dservice%2Echangepricelist%2Egetmoney%26pricelist%3D55231%26elid%3D8898549%26utm%5Fsource%3Dispmanager%5Fpanel&license=8898549&ip=37%2E230%2E114%2E96&utm_source=ispmanager_panel&pricelist=IM6L

Details

action — the type of action called: changepricelist — change plan
pricelist — new plan ID
ip — primary IP address on the server running ispmanager

Step 2. Order processing

Below are the automated ordering and license management features in the ispmanager partner account via API.

All functions support GET and POST requests.

All requests are processed using your real data in your real account. Therefore, if you complete an order with the skipbasket=on parameter, the order will be completed immediately, and funds will be debited from your account balance.

To complete the request, select the API address of your ispmanager account through which the resale will be processed:

{ "openapi": "3.0.4", "info": {"version": "1.0" }, "servers": [ { "url": "https://api-eu.ispmanager.com", "description": "API address for ispmanager client area" } ], "tags": [ { "name": "Actions with ispmanager licenses" } ], "paths": { "/?func=pricelist.export": { "get": { "tags": [ "Actions with ispmanager licenses" ], "summary": "Show list of all ispmanager plans", "responses": { "200": { "description": "OK" } } }, "parameters": [ { "$ref": "#/components/parameters/authinfoNotRequired" }, { "name": "func", "in": "query", "required": true, "schema": { "type": "string", "enum": [ "pricelist.export" ] } }, { "name": "itemtype", "in": "query", "required": true, "description": "**Service type**\n- **soft** — ispmanager licenses", "schema": { "type": "string", "enum": [ "soft" ] } }, { "$ref": "#/components/parameters/out" } ] }, "/?func=soft": { "get": { "tags": [ "Actions with ispmanager licenses" ], "summary": "Show list of all ispmanager licenses on account, including those in cart that are not paid for", "responses": { "200": { "description": "OK" } } }, "parameters": [ { "$ref": "#/components/parameters/authinfo" }, { "name": "func", "in": "query", "required": true, "schema": { "type": "string", "enum": [ "soft" ] } }, { "$ref": "#/components/parameters/out" } ] }, "/?func=soft.checkip": { "get": { "tags": [ "Actions with ispmanager licenses" ], "summary": "Check if IP address can be used to order ispmanager license", "responses": { "200": { "description": "- The **error** object means that an error occurred during the check.\n- The value \"$type\": \"exists\" means that a license already exists for the specified IP address.\n- Any other errors indicate that the service is temporarily unavailable.\n- If the **error** object is absent, no license was found for the IP address, and you can proceed with ordering a new license.", "content": { "application/json": { "schema": { "type": "object", "properties": { "doc": { "type": "object", "properties": { "error": { "type": "object", "description": "Error", "properties": { "$type": { "type": "string", "description": "Error type", "enum": ["exists"] } }, "required": ["$type"] } } } } }, "example": { "doc": { "error": { "$type": "exists", "$object": "ip", "$lang": "en", "group": { "$": "__object__ with '__value__' already exists" }, "msg": { "$": "IP address with '92.63.96.130' already exists" }, "param": [ { "$name": "object", "$type": "msg", "$msg": "IP address", "$": "ip" }, { "$name": "value", "$": "1.1.1.1" } ], "stack": { "action": { "$level": "16", "$user": "1234567", "$": "soft.checkip" } } } } } } } } } }, "parameters": [ { "$ref": "#/components/parameters/authinfo" }, { "name": "func", "in": "query", "required": true, "schema": { "type": "string", "enum": [ "soft.checkip" ] } }, { "$ref": "#/components/parameters/pricelist" }, { "name": "ip", "description": "**ispmanager license IP address**", "in": "query", "required": true, "schema": { "type": "string" } }, { "$ref": "#/components/parameters/out" } ] }, "/?func=soft.order.param": { "get": { "tags": [ "Actions with ispmanager licenses" ], "summary": "Order ispmanager license", "responses": { "200": { "description": "OK" } } }, "parameters": [ { "$ref": "#/components/parameters/authinfo" }, { "name": "func", "in": "query", "required": true, "schema": { "type": "string", "enum": [ "soft.order.param" ] } }, { "$ref": "#/components/parameters/period" }, { "$ref": "#/components/parameters/pricelist" }, { "$ref": "#/components/parameters/licname" }, { "$ref": "#/components/parameters/ip" }, { "$ref": "#/components/parameters/autoprolong" }, { "$ref": "#/components/parameters/skipbasket" }, { "$ref": "#/components/parameters/out" }, { "$ref": "#/components/parameters/sok" } ] }, "/?func=soft.edit": { "get": { "description": "To view information, specify the required parameters only. To change parameters, specify the new value in the appropriate field and select **ok** in the **sok** field", "tags": [ "Actions with ispmanager licenses" ], "summary": "View and modify information for single ispmanager license", "responses": { "200": { "description": "OK" } } }, "parameters": [ { "$ref": "#/components/parameters/authinfo" }, { "name": "func", "in": "query", "required": true, "schema": { "type": "string", "enum": [ "soft.edit" ] } }, { "$ref" : "#/components/parameters/elid" }, { "$ref" : "#/components/parameters/licname" }, { "$ref" : "#/components/parameters/ip" }, { "name": "clicked_button", "description": "**ispmanager license key**", "in": "query", "schema": { "type": "string", "enum": [ "newkey" ] } }, { "$ref": "#/components/parameters/out" }, { "name": "sok", "description": "Operation confirmation", "in": "query", "schema": { "type": "string", "enum": [ "ok" ] } } ] }, "/?func=service.prolong": { "get": { "tags": [ "Actions with ispmanager licenses" ], "summary": "Renew ispmanager license", "description": "The service will be renewed immediately after the request is executed, so there must be sufficient funds in the personal account balance.", "responses": { "200": { "description": "OK" } } }, "parameters": [ { "$ref": "#/components/parameters/authinfo" }, { "name": "func", "in": "query", "required": true, "schema": { "type": "string", "enum": [ "service.prolong" ] } }, { "$ref": "#/components/parameters/elid" }, { "$ref": "#/components/parameters/period" }, { "$ref": "#/components/parameters/out" }, { "$ref": "#/components/parameters/sok" } ] }, "/?func=service.changepricelist": { "get": { "tags": [ "Actions with ispmanager licenses" ], "summary": "Change ispmanager license plan", "responses": { "200": { "description": "OK" } } }, "parameters":[ { "$ref": "#/components/parameters/authinfo" }, { "name": "func", "in": "query", "required": true, "schema": { "type": "string", "enum": [ "service.changepricelist" ] } }, { "$ref": "#/components/parameters/elid" }, { "name": "pricelist", "in": "query", "description": "**ispmanager plan ID's**\n- **55227** — ispmanager light\n- **55228** — ispmanager pro\n- **55229** — ispmanager host", "required": true, "schema": { "type": "string", "enum": [ 55227, 55228, 55229 ] } }, { "$ref": "#/components/parameters/out" }, { "$ref": "#/components/parameters/sok" } ] }, "/?func=soft.suspend": { "get": { "tags": [ "Actions with ispmanager licenses" ], "summary": "Disable ispmanager license", "responses": { "200": { "description": "OK" } } }, "parameters":[ { "$ref": "#/components/parameters/authinfo" }, { "name": "func", "in": "query", "required": true, "schema": { "type": "string", "enum": [ "soft.suspend" ] } }, { "$ref": "#/components/parameters/elid" }, { "$ref": "#/components/parameters/out" } ] }, "/?func=soft.resume": { "get": { "tags": [ "Actions with ispmanager licenses" ], "summary": "Enable ispmanager license", "responses": { "200": { "description": "OK" } } }, "parameters":[ { "$ref": "#/components/parameters/authinfo" }, { "name": "func", "in": "query", "required": true, "schema": { "type": "string", "enum": [ "soft.resume" ] } }, { "$ref": "#/components/parameters/elid" }, { "$ref": "#/components/parameters/out" } ] }, "/?func=service.history": { "get": { "tags": [ "Actions with ispmanager licenses" ], "summary": "View ispmanager license history", "responses": { "200": { "description": "OK" } } }, "parameters": [ { "$ref": "#/components/parameters/authinfo" }, { "name": "func", "in": "query", "required": true, "schema": { "type": "string", "enum": [ "service.history" ] } }, { "$ref": "#/components/parameters/elid" }, { "$ref": "#/components/parameters/out" } ] }, "/?func=soft.delete": { "get": { "tags": [ "Actions with ispmanager licenses" ], "summary": "Delete ispmanager license", "responses": { "200": { "description": "OK" } } }, "parameters": [ { "$ref": "#/components/parameters/authinfo" }, { "name": "func", "in": "query", "required": true, "schema": { "type": "string", "enum": [ "soft.delete" ] } }, { "$ref": "#/components/parameters/elid" }, { "$ref": "#/components/parameters/out" } ] } }, "components": { "parameters": { "authinfoNotRequired":{ "name":"authinfo", "description":"**Login and password in LOGIN:PASSWORD format**", "in":"query", "required":false, "schema":{ "type":"string" } }, "authinfo": { "name": "authinfo", "description": "**Login and password in LOGIN:PASSWORD format**", "in": "query", "required": true, "schema": { "type": "string" } }, "out": { "name": "out", "description": "**Response format**\n- **xml** — data is returned in XML format (without pagination and filtering)\n- **devel** — XML with additional data describing user interface (useful for debugging custom plugins)\n- **text** — data in text format (without pagination and filtering)\n- **sjson** — data in JSON format\n- **json** — similar to sjson, but pretty-printed (useful for debugging)\n- **JSONdata** — similar to json, but without interface descriptions — data only (without pagination and filtering)\n- **xjson** — similar to default output format (HTML) but in JSON format (recommended for creating custom themes)\n- **bjson** — data in JSON format, but in a more structured form compared to sjson. Recommended as default for working with the API\n- **print** — HTML suitable for printing. Works only for data lists", "in": "query", "schema": { "type": "string", "enum": [ "xml", "devel", "text", "sjson", "json", "JSONdata", "xjson", "bjson", "print" ], "example": "bjson" } }, "period": { "name": "period", "description": "**Period in months**", "in": "query", "required": true, "schema": { "type": "integer", "enum": [ 1, 3, 6, 12 ] } }, "pricelist": { "name": "pricelist", "description": "**ispmanager plan ID's**\n- **55239** — ispmanager trial\n- **55227** — ispmanager light\n- **55228** — ispmanager pro\n- **55229** — ispmanager host", "in": "query", "required": true, "schema": { "type": "integer" } }, "sok": { "name": "sok", "description": "**Operation confirmation**", "in": "query", "required": true, "schema": { "type": "string", "enum": [ "ok" ] } }, "elid": { "name": "elid", "description": "**ispmanager license ID**", "in": "query", "required": true, "schema": { "type": "integer" } }, "autoprolong": { "name": "autoprolong", "description": "**Auto-renewal period in months**\n- Must be equal to the **period** value\n- If a different value or **null** is specified, or the parameter is not passed, auto-renewal will not be enabled for the service", "in": "query", "schema": { "type": "integer" } }, "skipbasket": { "name": "skipbasket", "description": "**Withdraw funds and activate the service immediately, bypassing the cart**", "in": "query", "schema": { "type": "string", "enum": [ "off", "on" ] } }, "licname": { "name": "licname", "description": "**ispmanager license name**", "in": "query", "required": false, "schema": { "type": "string" } }, "ip": { "name": "ip", "description": "**ispmanager license IP address**", "in": "query", "required": false, "schema": { "type": "string" } } } } }

Step 3. Updating license information

Information about your license and purchased modules is updated automatically once per day. To update license information immediately, update the data manually in the License management section of the ispmanager panel:

For partners

Reselling ispmanager licenses via API

Resale mechanics

Step 1. Configuring partner billing

Step 2. Order processing

Step 3. Updating license information