Open topic with navigation

Activation Server

The Activation Server Web service provides a license activation method, validating license input parameters and generating unlocking codes if the input is verified. For Instant SOLO Server Shared URL, this can be reached at https://secure.softwarekey.com/solo/webservices/activationserver.asmx. If you are using Instant SOLO Server Custom Shared URL or Instant SOLO Server Dedicated URL, replace secure.softwarekey.com with your sub-domain/domain. If you are running a standalone version of SOLO Server, replace secure.softwarekey.com/solo in the URL with the path to your SOLO Server instance. Please contact us if you need assistance determining the correct URL.

The activationserver.asmx page offers one Web method as follows:

ActivateLicense

Provides activation codes for a license after validating the license information passed in.

Input

Parameter Data Type Required/Optional Description
licenseID int Required The License ID. Not required with a serialNumber. Pass in 0 (zero) to omit.
password string Required The customer password or license activation password. Not required with a serialNumber. Pass in "" to omit.
productID int Required The Product ID.
code1 int Required Generally, the entry code.
code2 int Required Generally, the computer code.
serialNumber string Required Any serial number associated with the License ID. Required with no License ID. Pass in 0 (zero) for no serial.
requireRegistration bool Required True/False as to whether or not to require the customer to register before activation will be permitted.

Output

The result dataset contains the following parameters:

Parameter Data Type Description
Failure
ErrorCode int The resulting Return Code from execution of ActivateLicense method. A Return Code of 0 (zero) indicates success. Return Code values are as follows:
  • 40 - Security Check Failure
  • 50 - Invalid Parameters
  • 75 - Invalid Computer ID
  • 100 - Invalid License ID / Password/ SerialNumber
  • 150 - Unregistered Customers (when requriesRegistration is passed in as True)
  • 200 - Invalid Product ID
  • 300 - No More Keys Available
  • 400 - Invalid Option Type
  • 450 - License Expired
  • 500 - Unknown Error
ErrorMessage string Message from the error code. See descriptions in ErrorCode.
Success
Product string The full Product name (i.e., Product name + Product Option name).
LicenseID int The License ID. This is only set if the license is validated.
Quantity int The quantity on the license.
RegCode1 int Registration (Activation) Code 1.
RegCode2 int Registration (Activation) Code 2.
LicenseUpdate string The contents of the License Update field for the license.
UnlocksLeft int The number of unlocks remaining (after the current unlock action takes effect).