POST /service/api/ecom/shop/trials

Creates a trial license for a given product.

Request Information

URI Parameters

None.

URI Sample(s)

POST
https://unityapi.webrootcloudav.com/service/api/ecom/shop/trials

Body Parameters

Information about the product trial to process.

NOTE: Each partner account configuration can have different products set up, which restrict the values that can be specified for the LicenseCategoryName and LicenseSeats fields. Please work with your Webroot e-commerce business partner to identify valid order combinations.

CreateTrialProductRequestServiceModel
NameDescriptionTypeAdditional Information
LicenseSeats

The number of seats the trial license should have.

integer

Required

LicenseCategoryName

License category associated to this item.

Possible values are for example: OTSF, WSAV, WSAI, WSAC, SAEP, SDNS, SECA.

string

Required

LicenseKeycodeTypeId

The identifier of a license's keycode type.

Possible values are: 1 = standard license, 3 = parent license. If not specified, a default of 1 is assumed.

integer

None.

FirstName

The first name of the customer.

string

Required

LastName

The last name of the customer.

string

Required

Address1

Address line.

string

None.

City

The city of the customer.

string

None.

PostalCode

The postal code of the customer.

string

None.

State

The ISO two-letter or three-letter code for the state.

string

None.

Country

The ISO two-letter code for the country.

string

None.

CustomerEmail

The email address of the customer.

string

Required

CompanyName

The name of the customer's company.

string

None.

VendorCustomerCode

An arbitrary value that can be assigned to identify the recipient of the license.

string

None.

Modules

The modules to be added to this trial product.

Collection of CreateTrialProductRequestServiceModel_Module

None.

Sample Request

{
  "LicenseSeats": 110,
  "LicenseCategoryName": "SAEP",
  "LicenseKeycodeTypeId": 3,
  "FirstName": "John",
  "LastName": "Doe",
  "Address1": "Webroot Way 21",
  "City": "Broomfield",
  "PostalCode": "80021",
  "State": "CO",
  "Country": "US",
  "CustomerEmail": "jdoe@webroot.com",
  "CompanyName": "ACME, Inc.",
  "VendorCustomerCode": "E000975986",
  "Modules": [
    {
      "LicenseSeats": 708,
      "LicenseCategoryName": "SDNS"
    },
    {
      "LicenseSeats": 790,
      "LicenseCategoryName": "SECA"
    }
  ]
}                    
<CreateTrialProductRequestServiceModel xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/Webroot.UnityAPI.ServiceExtension.ECom.Models">
  <Address1>Webroot Way 21</Address1>
  <City>Broomfield</City>
  <CompanyName>ACME, Inc.</CompanyName>
  <Country>US</Country>
  <CustomerEmail>jdoe@webroot.com</CustomerEmail>
  <FirstName>John</FirstName>
  <LastName>Doe</LastName>
  <LicenseCategoryName>SAEP</LicenseCategoryName>
  <LicenseKeycodeTypeId>3</LicenseKeycodeTypeId>
  <LicenseSeats>110</LicenseSeats>
  <Modules>
    <CreateTrialProductRequestServiceModel_Module>
      <LicenseCategoryName>SDNS</LicenseCategoryName>
      <LicenseSeats>708</LicenseSeats>
    </CreateTrialProductRequestServiceModel_Module>
    <CreateTrialProductRequestServiceModel_Module>
      <LicenseCategoryName>SECA</LicenseCategoryName>
      <LicenseSeats>790</LicenseSeats>
    </CreateTrialProductRequestServiceModel_Module>
  </Modules>
  <PostalCode>80021</PostalCode>
  <State>CO</State>
  <VendorCustomerCode>E000975986</VendorCustomerCode>
</CreateTrialProductRequestServiceModel>                    

Response Information

Resource Description

Details about the newly created product trial.

CreateTrialProductResponseServiceModel
NameDescriptionTypeAdditional Information
Message

Specifies if the user has duplicate registration.

string

None.

LicenseId

A unique identifier for the license that was queried.

integer

None.

Keycode

Keycode identifying the license.

string

None.

ProductLineDescription

Description of the associated product line.

string

None.

Profile

A dictionary of profiles.

Dictionary of string [key] and CreateTrialProductResponseServiceModel_LicenseProfile [value]

None.

Customer

The customer associated to this license.

CreateTrialProductResponseServiceModel_Customer

None.

Sample Response

{
  "Message": null,
  "LicenseId": 170480060,
  "Keycode": "18B3E0E236BF43548866",
  "ProductLineDescription": "Webroot Business",
  "Profile": {
    "SAEP": {
      "LicenseCategoryName": "SAEP",
      "LicenseCategoryDescription": "Webroot Endpoint Protection",
      "LicenseSeats": 999,
      "LicenseKeycodeTypeId": 3,
      "StartDate": "2020-05-23T05:02:21",
      "ExpirationDate": "2022-11-15T00:54:57",
      "LicenseAttributeValue": 1,
      "LicenseAttributeValueDescription": "",
      "LicenseAttributeDescription": "",
      "CategoryTypeName": "full",
      "ItemHierarchyId": 1,
      "ItemHierarchyName": "primary",
      "LicenseStatusId": 2,
      "LicenseStatusDescription": "disabled",
      "UsagePricingModelId": null,
      "UsagePricingModelName": null,
      "UsageCheckDay": null
    },
    "SDNS": {
      "LicenseCategoryName": "SDNS",
      "LicenseCategoryDescription": "Webroot DNS Protection",
      "LicenseSeats": 505,
      "LicenseKeycodeTypeId": 3,
      "StartDate": "2020-05-22T18:02:50",
      "ExpirationDate": "2021-07-04T20:05:59",
      "LicenseAttributeValue": 1,
      "LicenseAttributeValueDescription": "",
      "LicenseAttributeDescription": "",
      "CategoryTypeName": "trial",
      "ItemHierarchyId": 2,
      "ItemHierarchyName": "secondary",
      "LicenseStatusId": 1,
      "LicenseStatusDescription": "active",
      "UsagePricingModelId": null,
      "UsagePricingModelName": null,
      "UsageCheckDay": null
    }
  },
  "Customer": {
    "VendorCustomerCode": "37673",
    "FirstName": "John",
    "LastName": "Doe",
    "Address1": "Webroot Way 21",
    "City": "Broomfield",
    "PostalCode": "80021",
    "State": "CO",
    "Country": "US",
    "CustomerEmail": "jdoe@webroot.com",
    "CompanyName": "ACME, Inc."
  }
}                    
<CreateTrialProductResponseServiceModel xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/Webroot.UnityAPI.ServiceExtension.ECom.Models">
  <Customer>
    <Address1>Webroot Way 21</Address1>
    <City>Broomfield</City>
    <CompanyName>ACME, Inc.</CompanyName>
    <Country>US</Country>
    <CustomerEmail>jdoe@webroot.com</CustomerEmail>
    <FirstName>John</FirstName>
    <LastName>Doe</LastName>
    <PostalCode>80021</PostalCode>
    <State>CO</State>
    <VendorCustomerCode>37673</VendorCustomerCode>
  </Customer>
  <Keycode>18B3E0E236BF43548866</Keycode>
  <LicenseId>170480060</LicenseId>
  <Message i:nil="true" />
  <ProductLineDescription>Webroot Business</ProductLineDescription>
  <Profile xmlns:d2p1="http://schemas.microsoft.com/2003/10/Serialization/Arrays">
    <d2p1:KeyValueOfstringCreateTrialProductResponseServiceModel_LicenseProfilefLvholdK>
      <d2p1:Key>SAEP</d2p1:Key>
      <d2p1:Value>
        <CategoryTypeName>full</CategoryTypeName>
        <ExpirationDate>2022-11-15T00:54:57</ExpirationDate>
        <ItemHierarchyId>1</ItemHierarchyId>
        <ItemHierarchyName>primary</ItemHierarchyName>
        <LicenseAttributeDescription></LicenseAttributeDescription>
        <LicenseAttributeValue>1</LicenseAttributeValue>
        <LicenseAttributeValueDescription></LicenseAttributeValueDescription>
        <LicenseCategoryDescription>Webroot Endpoint Protection</LicenseCategoryDescription>
        <LicenseCategoryName>SAEP</LicenseCategoryName>
        <LicenseKeycodeTypeId>3</LicenseKeycodeTypeId>
        <LicenseSeats>999</LicenseSeats>
        <LicenseStatusDescription>disabled</LicenseStatusDescription>
        <LicenseStatusId>2</LicenseStatusId>
        <StartDate>2020-05-23T05:02:21</StartDate>
        <UsageCheckDay i:nil="true" />
        <UsagePricingModelId i:nil="true" />
        <UsagePricingModelName i:nil="true" />
      </d2p1:Value>
    </d2p1:KeyValueOfstringCreateTrialProductResponseServiceModel_LicenseProfilefLvholdK>
    <d2p1:KeyValueOfstringCreateTrialProductResponseServiceModel_LicenseProfilefLvholdK>
      <d2p1:Key>SDNS</d2p1:Key>
      <d2p1:Value>
        <CategoryTypeName>trial</CategoryTypeName>
        <ExpirationDate>2021-07-04T20:05:59</ExpirationDate>
        <ItemHierarchyId>2</ItemHierarchyId>
        <ItemHierarchyName>secondary</ItemHierarchyName>
        <LicenseAttributeDescription></LicenseAttributeDescription>
        <LicenseAttributeValue>1</LicenseAttributeValue>
        <LicenseAttributeValueDescription></LicenseAttributeValueDescription>
        <LicenseCategoryDescription>Webroot DNS Protection</LicenseCategoryDescription>
        <LicenseCategoryName>SDNS</LicenseCategoryName>
        <LicenseKeycodeTypeId>3</LicenseKeycodeTypeId>
        <LicenseSeats>505</LicenseSeats>
        <LicenseStatusDescription>active</LicenseStatusDescription>
        <LicenseStatusId>1</LicenseStatusId>
        <StartDate>2020-05-22T18:02:50</StartDate>
        <UsageCheckDay i:nil="true" />
        <UsagePricingModelId i:nil="true" />
        <UsagePricingModelName i:nil="true" />
      </d2p1:Value>
    </d2p1:KeyValueOfstringCreateTrialProductResponseServiceModel_LicenseProfilefLvholdK>
  </Profile>
</CreateTrialProductResponseServiceModel>