website logo
⌘K
Getting Started
Introduction
Basic Concepts
Opening an Account
Creating & Configuring Products
Integrating SDK and Configuring License Fulfillment
Activate a Key-Based License
Vendor Platform
Issuing New Licenses
License Detail View
Order Detail View
Customer Detail View
Metadata
Analytics
Settings
Product Configuration
Product Features
Product Custom Fields
Product Versioning
License Policies
Product Bundles
License Entitlements
License Types
Activations & Device Transfers
Features
Custom Fields
License Start Date
License Note
Maintenance Period
Trial Licenses
Floating Licenses
License Activation Types
Portals
End-User Portal
Offline Portal
Air-Gapped Portal
License API
License API Authorization
License Activation/Deactivation
License Check
Consumption
Floating
Trial Key
Product Details
Device Variables
Changing Password
Management API
Making API Requests
Management API Authorization
Customer
Product
Order
License
Device
Analytics
SDKs
Tutorials
.NET/C# SDK
.NET/C# Management SDK
C++ SDK
Java SDK
Python SDK
Go SDK
Delphi SDK
Swift/Objective-C SDK
Android SDK
Unity SDK
Errors and Response Codes
Floating Server
API Reference
Deployment
Configuration
Floating Server UI
Securing the Server
Whitelabeling
FAQ
Floating Server Changelog
Integrations
Salesforce
FastSpring
Stripe
Shopify
Common Scenarios
Single Sign On (SSO)
Glossary
General
SDK Glossary
Vendor Platform
Product Configuration Glossary
License Configuration
Postman Collections
Frequently Asked Questions
Changelog
License API changelog
Platform changelog
Docs powered by
Archbee
Product Configuration

Product Bundles

15min

A product bundle is a specific type of product which groups several products together so that they can be activated and used with a single license.

General Process: Working With Product Bundles:

Generally, creating product bundles uses the following workflow:

  • Step 1: Initialize a product bundle
  • Step 2: Issue licenses for the product bundle.
  • Step 3: Activate each product individually using the same license.

Initialize a Product Bundle

Product bundles can be created on the Products page in the platform clicking on the button Add new bundle.

Adding New Product Bundle
Adding New Product Bundle


Enter the bundle name, code, authorization method select all the products which are going to be included in a bundle.

Setting Bundle Values
Setting Bundle Values


The bundle code must be unique from other bundle and other product codes

You can only bundle products using the same authorization method

The Bundle code, authorization method and selected products cannot be edited after the bundle is created. You can edit their name, and delete or disable / re-enable them at a later date.

Issuing Bundle Licenses in the Vendor Platform:

An order for bundles can only contain product licenses or bundle licenses, but not both.

Start as you normally would with any other license:

  1. Open the Order Creator, and optionally add Customer and order information. Press "Next"
  2. Toggle "Create order for product bundle"
Create Order for Bundle
Create Order for Bundle


In the product bundle selector:

  • Select the bundle you wish to issue licenses for.
  • Specify the license policy to be associated for each product individually.
  • Click "Confirm", "next" and "Create order"
Confirming Bundle Settings
Confirming Bundle Settings

Creating Order
Creating Order


The License Key can be found in the order, under the license tab:

New License Key
New License Key


Activating Licenses for Bundled Products

The License created for the bundle can be used to activate the products within the bundle. The products needs to be activated separately. For example, you cannot use the bundle code to activate the license for all of the products in that bundle.

Assigning Users to User-Based Product Bundles

Users are assigned to the user-based bundle license and can then log in to the individual products using the same credentials separately.

There is no way to assign users to individual products of a bundle. In other words, a user will be assigned to all products within the bundle. The Max users will therefore be the smallest value of the Max users of all the individual license policies used.

Activating Licenses of Bundles through the LicenseAPI

The API interfaces remain consistent, as we continue to operate with standard licenses for processes such as activation and verification.

For instance, consider a license bundle named "Bundle PRO" with the code "bunpro," which is associated with a key-based license having the serial number 1111-2222-3333-4444. This bundle encompasses two products: "Product One" (code: prodone) and "Product Two" (code: prodtwo).

To initiate the license activation for "Product One" within the bundle, the procedure involves employing the bundle license key, the code for "Product One," and the hardware ID of the relevant device. It's important to note that the bundle license functions as a mere placeholder, serving to manage the license key and LicenseUsers information.

JS
|
const axios = require('axios');
const data = JSON.stringify({
  "product": "prodone",
  "license_key": "1111-2222-3333-4444",
  "hardware_id": "test-hardware-id-1",
});

const config = {
  method: 'post',
  url: 'https://api.licensespring.com/api/v4/activate_license/',
  headers: { 
    '\'Content-Type\'': '\'application/json\'', 
    'Date': 'Thu, 28 Jan 2021 09:07:27 GMT', 
    'Authorization': 'algorithm="hmac-sha256",headers="date",signature="9Km8AoACsFfRf9+JW4gcnHMmvWoPaZIwlaZ3HeZxdgQ=",apikey="5225d654-f6e5-41f0-af90-4237a597134b"', 
    'Content-Type': 'application/json'
  },
  data : data
};

axios(config)
.then(function (response) {
  console.log(JSON.stringify(response.data));
})
.catch(function (error) {
  console.log(error);
});


Working with Product Bundles with the Management API

There are two primary, product bundle-specific API calls:

  • List Products in a Bundle shows all products in a bundle the requesting manager has access permissions to.
  • List Bundles for a Product shows all bundles for a product the requesting manager has access permissions to.



Updated 05 Sep 2023
Did this page help you?
PREVIOUS
Air-Gapped License Policy
NEXT
License Entitlements
Docs powered by
Archbee
TABLE OF CONTENTS
General Process: Working With Product Bundles:
Initialize a Product Bundle
Issuing Bundle Licenses in the Vendor Platform:
Activating Licenses for Bundled Products
Assigning Users to User-Based Product Bundles
Activating Licenses of Bundles through the LicenseAPI
Working with Product Bundles with the Management API
Docs powered by
Archbee