User Settings Main Page -> Licence activation

Licence activation

Summary

The Licence Activation page is where you choose and activate your awaBerry account plan. You can select between free, connect, or commercial usage plans. Once you select a plan, the system automatically handles the activation or directs you to a secure checkout for paid subscriptions. This page ensures you have the correct license to use awaBerry services and connect your devices.

Page Access

You can access this page by navigating to: /licenceinit

Page Functionalities

Licence Selection Area

This section allows you to select your preferred usage type and view details about your chosen plan.

Usage Type Buttons: Two buttons, 'Private Usage' and 'Commercial Usage', let you specify how you intend to use awaBerry. Selecting one highlights it and informs the system of your choice.
Selected Plan Display: Once a plan is chosen or loaded, this area shows its name, category (e.g., 'private usage - free plan', 'Free usage, connect to devices with received api key and secret', 'Commercial Usage'), and any trial information, such as the number of free trial days.
'Change' Button: Appears next to your selected plan (unless it's a 'connect' plan) and allows you to go back to the pricing page to choose a different plan.
'See Plan Details' Button: Opens a popup with detailed information about the currently selected plan, including features and benefits.
'Select Licence' Button: Appears after you have chosen a usage type and directs you to the relevant pricing page to select a specific license plan.

Activation Status Area

Below the plan selection, this area dynamically displays the status of your license activation or subscription process.

Activation Progress Indicator: For free or connect licenses, a spinning circle ('Circular Progress Indicator') with text like 'Activating free usage licence' or 'Activating free connect licence' shows that the system is processing your request.
Activation Success Message: A green checkmark and the message 'Activation of licence successful' indicates a successful license activation. This is followed by a 'Connect first device' button to guide you to the next step.
Activation Error Message: A red error icon and the message 'Error on activation occurred - try again later' indicates that something went wrong during activation.
Checkout Progress Indicator: For paid subscriptions, a spinning circle and 'Open checkout page' text indicate that the system is preparing the external payment portal link.
'Subscribe' Button: For paid subscription plans, this button initiates the secure checkout process.
Trial Information: If your chosen subscription includes a trial, a message like 'During the trial phase, cancelation is possible at any time with no costs.' will be displayed.
Cancelled Checkout Message: If you navigate back from the payment portal without completing the subscription, a 'You have cancelled the checkout process. Please select another plan or start again.' message will appear.

Scenario Executions

Possible usage steps within this page

Scenario 1: Activating a Free Usage Licence

This scenario describes how a new user activates the free personal usage plan.

On the Licence activation page, select the 'Private Usage' option.
Click the 'Select Licence' button to proceed to the pricing page (which automatically redirects back to this page if a plan is pre-selected as 'basic').
The system will display 'Activating free usage licence'.
Upon success, you will see 'Activation of licence successful' and a 'Connect first device' button.
Click 'Connect first device' to continue setting up your devices.

Scenario 2: Activating a Free Connect Licence

This scenario describes how a user activates the free connect plan.

On the Licence activation page, select the 'Commercial Usage' option.
Click the 'Select Licence' button to proceed to the pricing page, and then select the 'Connect' plan.
The system will display 'Activating free connect licence'.
Upon success, you will see 'Activation of licence successful' and a 'Connect first device' button.
Click 'Connect first device' to continue setting up your devices.

Scenario 3: Subscribing to a Commercial Plan

This scenario describes how a user subscribes to a paid commercial plan.

On the Licence activation page, select the 'Commercial Usage' option.
Click the 'Select Licence' button to go to the pricing page.
Choose a commercial plan (e.g., 'Pro Monthly') and proceed.
The system will display 'Open checkout page' and then automatically open a new browser tab for the payment process.
Complete the payment in the new tab.
Upon returning to the awaBerry application (after successful payment), you should see 'Activation of licence successful' and a 'Connect first device' button.

Possible errors which may occur on this page

Error: Activation Fails (Free/Connect Licence)

If there's an issue during the activation of a free or connect license, you will see the message 'Error on activation occurred - try again later'.

Why it happens: This can occur due to temporary network problems, issues with your user session, or a problem with the awaBerry backend services.
What to do: Ensure you have a stable internet connection. Try activating the license again after a short while. If the problem persists, check your login status or contact support.

Error: User Not Logged In

Although the application is designed to redirect to login if not logged in, if an activation attempt somehow occurs without an active user session, it will likely result in an activation error.

Why it happens: The system requires an active user session to process license activations.
What to do: Ensure you are properly logged into your awaBerry account before attempting to activate or subscribe to a license.

Error: Checkout Process Cancelled

If you start a subscription process for a paid plan but do not complete the payment, returning to this page will display 'You have cancelled the checkout process. Please select another plan or start again.'

Why it happens: You closed the payment portal tab or navigated away before completing the payment.
What to do: If you still wish to subscribe, simply select your desired plan again and proceed to checkout. If you intended to cancel, you can choose a different plan or continue with a free option if available.