Reselling third-party licenses via API

Third-party licenses are software licenses issued in your client area under Licenses → Third-party licenses. These licenses can be used on a server without ispmanager. Installation is performed through the server console.

Automating the resale of third-party licenses using the 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. The end customer orders a third-party license in their partner billing account.
License order in the ispmanager client area. The partner then processes the end customer's order and purchases the third-party license in their ispmanager client area. This can be done through API automation or as a manual purchase.
License activation and management. The end customer manages the third-party license through their partner billing account.

License management

Below are listed the automatic ordering and module management functions in the ispmanager system 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.

Before making a request, select the ispmanager account API address through which reselling will take place:

{
    "openapi": "3.0.4",
    "info": {
        "version": "1.0.0"
    },
    "servers": [
        {
            "url": "https://api-eu.ispmanager.com",
            "description": "API address for ispmanager client area"
        }
    ],
    "tags": [
        {
            "name": "Other software"        }
    ],
    "paths": {
        "/?func=pricelist.export": {
            "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- **softexternal** — other software",
                    "schema": {
                        "type": "string",
                        "enum": [
                            "softexternal"
                        ]
                    }
                },
                {
                    "$ref": "#/components/parameters/out"
                }
            ],
            "get": {
                "tags": [
                    "Other software"
                ],
                "summary": "Show list of all plans",
                "responses": {
                    "200": {
                        "description": "OK"
                    }
                }
            }
        },
        "/?func=softexternal": {
            "parameters": [
                {
                    "$ref": "#/components/parameters/authinfo"
                },
                {
                    "name": "func",
                    "in": "query",
                    "required": true,
                    "schema": {
                        "type": "string",
                        "enum": [
                            "softexternal"
                        ]
                    }
                },
                {
                    "$ref": "#/components/parameters/out"
                }
            ],
            "get": {
                "tags": [
                    "Other software"
                ],
                "summary": "Show list of all other software licenses on account, including those in cart that are not paid for",
                "responses": {
                    "200": {
                        "description": "OK"
                    }
                }
            }
        },
        "/mancgi/bitninja_check_email.py": {
            "get": {
                "tags": [
                    "Other software"
                ],
                "summary": "Check if an email address can be used to order BitNinja",
                "parameters": [
                    {
                        "$ref": "#/components/parameters/authinfo"
                    },
                    {
                        "name": "email",
                        "in": "query",
                        "required": true,
                        "description": "**Email address to check**",
                        "schema": {
                            "type": "string"
                        }
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "oneOf": [
                                        {
                                            "type": "object",
                                            "properties": {
                                                "doc": {
                                                    "type": "object",
                                                    "properties": {
                                                        "$status": {
                                                            "type": "string",
                                                            "enum": [
                                                                "busy"
                                                            ]
                                                        }
                                                    }
                                                }
                                            }
                                        },
                                        {
                                            "type": "object",
                                            "properties": {
                                                "doc": {
                                                    "type": "object",
                                                    "properties": {
                                                        "$status": {
                                                            "type": "string",
                                                            "enum": [
                                                                "free"
                                                            ]
                                                        }
                                                    }
                                                }
                                            }
                                        },
                                        {
                                            "type": "object",
                                            "properties": {
                                                "doc": {
                                                    "type": "object",
                                                    "properties": {
                                                        "$status": {
                                                            "type": "string",
                                                            "enum": [
                                                                "linked to your account"
                                                            ]
                                                        }
                                                    }
                                                }
                                            }
                                        },
                                        {
                                            "type": "object",
                                            "properties": {
                                                "doc": {
                                                    "type": "object",
                                                    "properties": {
                                                        "error": {
                                                            "type": "object",
                                                            "properties": {
                                                                "$type": {
                                                                    "type": "string",
                                                                    "enum": [
                                                                        "client"
                                                                    ]
                                                                },
                                                                "$object": {
                                                                    "type": "string",
                                                                    "enum": [
                                                                        "error"
                                                                    ]
                                                                },
                                                                "detail": {
                                                                    "type": "object",
                                                                    "properties": {
                                                                        "$": {
                                                                            "type": "string"
                                                                        }
                                                                    }
                                                                }
                                                            }
                                                        }
                                                    }
                                                }
                                            }
                                        }
                                    ]
                                },
                                "examples": {
                                    "busy": {
                                        "summary": "Email is used by someone else",
                                        "value": {
                                            "doc": {
                                                "$status": "busy"
                                            }
                                        }
                                    },
                                    "free": {
                                        "summary": "Email is free",
                                        "value": {
                                            "doc": {
                                                "$status": "free"
                                            }
                                        }
                                    },
                                    "linked": {
                                        "summary": "Email is linked to your account",
                                        "value": {
                                            "doc": {
                                                "$status": "linked to your account"
                                            }
                                        }
                                    },
                                    "error": {
                                        "summary": "Error (invalid credentials)",
                                        "value": {
                                            "doc": {
                                                "error": {
                                                    "$type": "client",
                                                    "$object": "error",
                                                    "detail": {
                                                        "$": "Invalid username or password "
                                                    }
                                                }
                                            }
                                        }
                                    }
                                }
                            }
                        }
                    }
                }
            }
        },
        "/?func=softexternal.order.param": {
            "parameters": [
                {
                    "$ref": "#/components/parameters/authinfo"
                },
                {
                    "name": "func",
                    "in": "query",
                    "required": true,
                    "schema": {
                        "type": "string",
                        "enum": [
                            "softexternal.order.param"
                        ]
                    }
                },
                {
                    "$ref": "#/components/parameters/periodSoftExternalOrder"
                },
                {
                    "$ref": "#/components/parameters/pricelistSoftExternal"
                },
                {
                    "$ref": "#/components/parameters/autoprolong"
                },
                {
                    "$ref": "#/components/parameters/skipbasket"
                },
                {
                    "name": "licname",
                    "description": "**License name**",
                    "in": "query",
                    "schema": {
                        "type": "string"
                    }
                },
                {
                    "name": "ip",
                    "description": "**Server IP address**",
                    "in": "query",
                    "schema": {
                        "type": "string"
                    }
                },
                {
                    "name": "bitninja_email",
                    "description": "**Email address**",
                    "in": "query",
                    "required": false,
                    "schema": {
                        "type": "string"
                    }
                },
                {
                    "$ref": "#/components/parameters/out"
                },
                {
                    "$ref": "#/components/parameters/sok"
                }
            ],
            "get": {
                "tags": [
                    "Other software"
                ],
                "summary": "Order license",
                "responses": {
                    "200": {
                        "description": "OK"
                    }
                }
            }
        },
        "/?func=softexternal.edit": {
            "parameters": [
                {
                    "$ref": "#/components/parameters/authinfo"
                },
                {
                    "name": "func",
                    "in": "query",
                    "required": true,
                    "schema": {
                        "type": "string",
                        "enum": [
                            "softexternal.edit"
                        ]
                    }
                },
                {
                    "$ref": "#/components/parameters/elidForSoftexternal"
                },
                {
                    "$ref": "#/components/parameters/autoprolong"
                },
                {
                    "$ref": "#/components/parameters/out"
                },
                {
                    "name": "sok",
                    "description": "Operation confirmation",
                    "in": "query",
                    "schema": {
                        "type": "string",
                        "enum": [
                            "ok"
                        ]
                    }
                }
            ],
            "get": {
                "tags": [
                    "Other software"
                ],
                "summary": "View and modify information for single license",
                "description": "To view information, specify only the required parameters. To change parameters, specify the new value in the appropriate field and select **ok** in the **sok** field",
                "responses": {
                    "200": {
                        "description": "OK"
                    }
                }
            }
        },
        "/?func=service.prolong": {
            "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"
                }
            ],
            "get": {
                "tags": [
                    "Other software"
                ],
                "summary": "Renew license",
                "description": "The service will be renewed immediately after the request is executed, so there must be sufficient funds in the account balance",
                "responses": {
                    "200": {
                        "description": "OK"
                    }
                }
            }
        },
        "/?func=service.history": {
            "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"
                }
            ],
            "get": {
                "tags": [
                    "Other software"                ],
                "summary": "View license history",
                "responses": {
                    "200": {
                        "description": "OK"
                    }
                }
            }
        },
        "/?func=softexternal.suspend": {
            "get": {
                "tags": [
                    "Other software"
                ],
                "summary": "Disable license",
                "responses": {
                    "200": {
                        "description": "OK"
                    }
                }
            },
            "parameters": [
                {
                    "$ref": "#/components/parameters/authinfo"
                },
                {
                    "name": "func",
                    "in": "query",
                    "required": true,
                    "schema": {
                        "type": "string",
                        "enum": [
                            "softexternal.suspend"
                        ]
                    }
                },
                {
                    "$ref": "#/components/parameters/elid"
                },
                {
                    "$ref": "#/components/parameters/out"
                }
            ]
        },
        "/?func=softexternal.resume": {
            "get": {
                "tags": [
                    "Other software"
                ],
                "summary": "Enable license",
                "responses": {
                    "200": {
                        "description": "OK"
                    }
                }
            },
            "parameters": [
                {
                    "$ref": "#/components/parameters/authinfo"
                },
                {
                    "name": "func",
                    "in": "query",
                    "required": true,
                    "schema": {
                        "type": "string",
                        "enum": [
                            "softexternal.resume"
                        ]
                    }
                },
                {
                    "$ref": "#/components/parameters/elid"
                },
                {
                    "$ref": "#/components/parameters/out"
                }
            ]
        },
        "/?func=softexternal.delete": {
            "parameters": [
                {
                    "$ref": "#/components/parameters/authinfo"
                },
                {
                    "name": "func",
                    "in": "query",
                    "required": true,
                    "schema": {
                        "type": "string",
                        "enum": [
                            "softexternal.delete"
                        ]
                    }
                },
                {
                    "$ref": "#/components/parameters/elidForSoftexternal"
                },
                {
                    "$ref": "#/components/parameters/out"
                }
            ],
            "get": {
                "tags": [
                    "Other software"
                ],
                "summary": "Delete license",
                "responses": {
                    "200": {
                        "description": "OK"
                    }
                }
            }
        }
    },
    "components": {
        "parameters": {
            "authinfo": {
                "name": "authinfo",
                "description": "**Username and password in LOGIN:PASSWORD format**",
                "in": "query",
                "required": true,
                "schema": {
                    "type": "string"
                }
            },
            "authinfoNotRequired": {
                "name": "authinfo",
                "description": "**Username and password in LOGIN:PASSWORD format**",
                "in": "query",
                "required": false,
                "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": "**Payment period in months**",
                "in": "query",
                "required": true,
                "schema": {
                    "type": "integer",
                    "enum": [
                        1,
                        3,
                        6,
                        12
                    ]
                }
            },
            "pricelistSoftExternal": {
                "name": "pricelist",
                "description": "**Other software license plan ID**\n- **55369** — BitNinja",
                "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": "**Other software license ID**",
                "in": "query",
                "required": true,
                "schema": {
                    "type": "integer"
                }
            },
            "elidForSoftexternal": {
                "name": "elid",
                "description": "**Other software 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": "string"
                }
            },
            "skipbasket": {
                "name": "skipbasket",
                "description": "**Withdraw funds and activate the service immediately, bypassing the cart**",
                "in": "query",
                "schema": {
                    "type": "string",
                    "enum": [
                        "off",
                        "on"
                    ]
                }
            },
            "periodWithTrial": {
                "name": "period",
                "description": "**Payment period in months**\n- Value **-100** means trial period",
                "in": "query",
                "required": true,
                "schema": {
                    "type": "integer",
                    "enum": [
                        1,
                        3,
                        6,
                        12,
                        -100
                    ]
                }
            },
            "periodSoftExternalOrder": {
                "name": "period",
                "description": "**Payment period in months**\n- Value **-100** means trial period",
                "in": "query",
                "required": true,
                "schema": {
                    "type": "integer",
                    "enum": [
                        1,
                        3,
                        6,
                        12,
                        -100
                    ]
                }
            },
            "comment": {
                "name": "comment",
                "description": "**Comment**\n- Makes it easier to find the license in the orders list",
                "in": "query",
                "required": false,
                "schema": {
                    "type": "string"
                }
            }
        }
    }
}

For partners

Reselling third-party licenses via API

Resale mechanics

License management