Brands and Packages

Brands

A brand represents the configuration of a partner within the BaseKit application. Users created within a specific brand will belong to that brand, and are securely partitioned from all other brands.

You will be provided with a brand reference. This is a unique number that is used to identify your brand. This may be required for some API calls and will always be a parameter named brandRef. Your API credentials are locked to your brand, so you can’t access users in other brands, and other brands can’t access your users.

📘

Note

Users are sometimes referred to as 'account holders' and the two terms may be used interchangeably.

Packages

All users have a package that represents the features and capabilities that are available for them to use within their account. For example, a package may designate the number of sites they are allowed to create, the templates they are allowed to access, the storage limit they have available, etc.

• A typical brand will have one free package and three premium packages. These packages may only be used by users within the corresponding brand.
• The free package will typically be designated as the brand’s default package. The default package is automatically assigned to new users created within this brand.
• Users can only have one package at any given time. If a new package is given to the user then the existing package is automatically expired.
• All packages have a billing period that indicates how regularly the user has decided to pay for their subscription. Typically this will be either monthly or annually.

Package models

Every partner integration will choose one of the following package models. Which one to choose will depend on the marketing and commercialisation strategy for the project. It is recommended that all partners implement the Freemium model, which has been shown to give the best results.

Trial

A trial package provides users with access to a complete set of features for a limited period of time. The period of time is set as a number of days and is typically between 7 and 30 days.

Each trial package will mirror a paid package, with the only difference being that it is time limited. If the user decides to upgrade, they will move to the corresponding paid version of the package.

If the user does not subscribe to a paid package during the trial period, they will be moved back to the brand’s default package. This will usually mean that they lose some of the premium features that they have had access to during the trial. For example, they may no longer be able to publish their site without paying for the service.

Billing cycles

Every paid package is assigned to a billing cycle that represents how frequently the user is making subscription payments for the service.

The frequency is specified as a number of months. For example, a billing frequency of 3 means that the package subscription payment is made by the user every 3 months. The typical billing frequencies are 1 for monthly and 12 for annual, but any number may be used.

It is critical that you indicate the correct billing frequency in all API calls. This is used to tell the provisioning engine how to update the user’s package, and also used to synchronise billing reports.