Plan and billing. Update documentation

_includes/docs/paas/legacy-subscriptions.md

@@ -550,10 +550,10 @@ Transitioning to the new model is seamless and requires no migration of data.
 
 To terminate your ThingsBoard Cloud subscription, follow these steps:
 
-- Log in to ThingsBoard Cloud as Tenant Administrator;
-- Go to account settings by clicking the **three-dot icon** in the upper-right corner of the screen and selecting "**Account**" from the dropdown menu;
-- Under the "**Profile**" tab, click the orange "**Delete account**" button;
-- Follow the instructions to cancel your subscription;
+- Log in to ThingsBoard Cloud as Tenant Administrator.
+- Go to account settings by clicking the **three-dot icon** in the upper-right corner of the screen and selecting **Account** from the dropdown menu.
+- Under the **Profile** tab, click the orange **Delete account** button.
+- Follow the instructions to cancel your subscription.
 - Confirm the action by clicking the "**I understand the consequences, delete account**" button.
 
 In the future, the subscription termination button will be moved to the "**Plan and billing**" page in the ThingsBoard navigation menu.

docs/paas/billing-info.md

@@ -5,29 +5,7 @@ assignees:
 title: Plan and billing
 description: Billing options via ThingsBoard Cloud
 redirect_from: "/products/paas/billing-info/"
-subscription:
-    0:
-        image: /images/cloud/subscription.png
-        title: 'Subscription details'
-    1:
-        image: /images/cloud/subscription-plan-usage.png
-        title: 'Plan usage'
-billingInfo:
-    0:
-        image: /images/cloud/billing-info.png
-updatePaymentMethod:
-    0:
-        image: /images/cloud/update-payment-method.png
-updateBillingInfo:
-    0:
-        image: /images/cloud/update-billing-info.png
-invoices:
-    0:
-        image: /images/cloud/invoices.png
-upcomingInvoice:
-    0:
-        image: /images/cloud/upcoming-invoice.png
-        title: 'Upcoming invoice preview'
+
 ---
 
 {% assign docsPrefix = "paas/" %}
@@ -36,47 +14,131 @@ upcomingInvoice:
 * TOC
 {:toc}
 
-The **ThingsBoard Cloud** allows customers to easily purchase subscription plans online. The online payment processing is secured by [Stripe](https://stripe.com/), which allows both credit and debit cards. ThingsBoard Inc. has no access to your card data.
-You can easily pay for the subscription online, without manual paperwork.
+The **Plan and billing** section of [ThingsBoard Cloud](https://thingsboard.cloud/signup){:target="_blank"} allows tenant administrators to manage subscription plans, monitor usage, configure billing details, and review invoices. 
+
+All online payments are securely processed by [Stripe](https://stripe.com/){:target="_blank"}. ThingsBoard Inc. does not store or have access to your card data.
+
+{% capture difference %}
+**Notice:** Payments are non‑refundable.
+{% endcapture %}
+{% include templates/info-banner.md content=difference %}
+
+## Accessing Plan and billing
+
+Navigate to **Plan and billing** from the main menu. 
 
-Notice: payments are non-refundable.
+> This section is available to Tenant administrators only.
+
+At the top of the page, the current subscription name and status are displayed.
+
+If attention is required, warning banners may appear (for example, _"Your current plan is deprecated"_ or _"Your billing information is incomplete"_). 
+Each banner contains a direct action link to resolve the issue.
 
 ## Subscription
 
-**Subscription** tab displays all details about current subscription including current subscription plan, subscription status, current subscription period, applied discount.
-**Plan details** section displays current subscription plan limits. It is also possible to view current plan usage by clicking on **Show usage** toggle. 
+The **Subscription** tab provides an overview of the current subscription and plan limits.
 
-{% include images-gallery.html imageCollection="subscription" %}
+<b><font size="4">Management</font></b>
 
-## Billing information
+The **Management** section displays:
+- **Subscription plan** – current plan name and status.
+- **Subscription period** – start and end dates of the current billing cycle.
+- **Next charge** – amount and scheduled billing date.
+
+Available actions:
+- [Update plan](#update-plan) – upgrade or change the subscription plan.
+- [Cancel subscription](/docs/{{docsPrefix}}subscriptions/#how-to-cancel-my-subscription){:target="_blank"} – cancel the active subscription.
+- **Apply coupon** – apply a valid discount coupon.
+
+<b><font size="4">Subscription plan data</font></b>
+
+This section displays plan limits and usage indicators.
+
+You can switch between:
+- **Entities & Features** – limits for entities, features, and add-ons.
+- **API calls** – monthly quotas for messages, data points, rule engine executions, and other API-related limits.
+
+Usage bars show current consumption relative to plan limits.   
+The **Add to plan (+)** action allows extending limits or enabling additional features where available.
+
+### Update plan
+
+To change the current subscription plan, click **Update plan**.   
+
+<b><font size="4">Step 1: Choose the Subscription Plan</font></b>   
+At this step, all available ThingsBoard Cloud subscription plans are displayed. Your current plan is marked with the **Current plan** label.
+
+To select another plan, click **Select** under the required option. 
+
+To update your current plan, click **Customize** under the current plan.
 
-**Billing information** tab allows managing current payment method (credit or debit card details) and billing details such as company name and billing address used for invoicing.
+<b><font size="4">Step 2: Customize</font></b>   
+In this step, you can customize the selected plan by enabling add-ons and purchasing additional resource packs.
 
-{% include images-gallery.html imageCollection="billingInfo" %}
+<b><font size="3">Add-ons</font></b>   
+Allow enabling optional features, such as: [White labeling](/docs/{{docsPrefix}}user-guide/white-labeling/){:target="_blank"}, [Edge Computing](/docs/user-guide/edge-computing/){:target="_blank"}, [Trendz Analytics](/docs/trendz/){:target="_blank"}.
+
+<b><font size="3">Top-ups</font></b>   
+Allow extending plan limits. You can switch between:
+- **Entities** – device, asset, customer, user, integration, and converter limits.
+- **API calls** – message traffic, compute, storage, alarms, and email/SMS quotas.
+
+To increase a limit, use the **+ / -** controls in the corresponding section.
+
+If additional resources require a higher plan, the wizard displays an **Update to ... plan** option.
+
+Click **Next: Summary** to proceed.
+
+<b><font size="4">Step 3: Summary</font></b>   
+The summary step displays the final subscription price.
+
+If the subscription is updated in the middle of a billing cycle, the wizard may display an additional charge after plan update.
+
+To confirm changes and apply the selected plan configuration, click **Update plan**.
+
+## Billing information
+
+The **Billing information** tab lets you manage your **payment method** and **billing details** used for invoicing.
 
 ### Payment method
 
-Allows managing current credit or debit card details. You may easily update it at any time by clicking on **Update** button.
-In order to pay with the card the ***Owner name***, ***Country***, ***Card number***, ***Expiry date*** and ***CVC*** should be populated.
+Shows the currently configured payment method. If no card is added, a warning message is displayed. 
+
+To add a payment method, click **Add** and provide the card holder name, country, card number, expiry date, and CVC.    
+ThingsBoard Cloud supports both **credit and debit cards**.
+
+> All payment processing is handled securely by [Stripe](https://stripe.com/){:target="_blank"}. 
 
-{% include images-gallery.html imageCollection="updatePaymentMethod" %}
+Once validated, the card becomes the active payment method for future charges.
 
 ### Billing information
 
-Consist of company contact details and billing address and is used by Stripe to generate the invoice. You may easily update this info by clicking on **Update** button.
+**Billing information** is used to generate invoices.
 
-{% include images-gallery.html imageCollection="updateBillingInfo" %}
+To update billing details, click **Update**, fill in the required fields, and save your changes.
 
 ## Invoices
 
-**Invoices** tab displays list of automatically generated invoices. All invoices are available for download in a PDF-format.
+The **Invoices** tab displays a list of all generated invoices for your subscription. 
+
+Each invoice entry includes the invoice date, amount and currency, invoice number, payment type, and status. 
+
+You can download invoices in PDF format or open them in a new browser tab. 
 
-{% include images-gallery.html imageCollection="invoices" %}
+Invoices are generated automatically at the end of each billing cycle.
 
 ## Upcoming invoice
 
-**Upcoming invoice** tab displays upcoming invoice preview that will be generated at the beginning of the next billing cycle. 
+The **Upcoming invoice** tab shows a preview of the next invoice that will be generated.
+
+> Note: This is a preview only. The invoice is not created until the billing cycle is completed.
+
+## Audit logs
+
+The **Audit logs** tab provides a history of billing‑related actions.
+
+Audit logs help track administrative actions and support troubleshooting and compliance requirements.
 
-Note: When you are viewing an upcoming invoice, you are simply viewing a preview – the invoice has not yet been created.
+## Learn more about plans
 
-{% include images-gallery.html imageCollection="upcomingInvoice" %}
+Learn more about available subscription plans, plan limits, and included features on the [Subscription page](/docs/paas/subscriptions/){:target="_blank"}.

docs/paas/eu/billing-info.md

@@ -3,30 +3,8 @@ layout: docwithnav-paas-eu
 assignees:
 - ashvayka
 title: Plan and billing
-description: Billing options via ThingsBoard Cloud
-subscription:
-    0:
-        image: /images/cloud/subscription.png
-        title: 'Subscription details'
-    1:
-        image: /images/cloud/subscription-plan-usage.png
-        title: 'Plan usage'
-billingInfo:
-    0:
-        image: /images/cloud/billing-info.png
-updatePaymentMethod:
-    0:
-        image: /images/cloud/update-payment-method.png
-updateBillingInfo:
-    0:
-        image: /images/cloud/update-billing-info.png
-invoices:
-    0:
-        image: /images/cloud/invoices.png
-upcomingInvoice:
-    0:
-        image: /images/cloud/upcoming-invoice.png
-        title: 'Upcoming invoice preview'
+description: Billing options via ThingsBoard EU Cloud
+
 ---
 
 {% assign docsPrefix = "paas/eu/" %}
@@ -35,47 +13,131 @@ upcomingInvoice:
 * TOC
 {:toc}
 
-The **ThingsBoard Cloud** allows customers to easily purchase subscription plans online. The online payment processing is secured by [Stripe](https://stripe.com/), which allows both credit and debit cards. ThingsBoard Inc. has no access to your card data.
-You can easily pay for the subscription online, without manual paperwork.
+The **Plan and billing** section of [ThingsBoard EU Cloud](https://eu.thingsboard.cloud/signup){:target="_blank"} allows tenant administrators to manage subscription plans, monitor usage, configure billing details, and review invoices.
+
+All online payments are securely processed by [Stripe](https://stripe.com/){:target="_blank"}. ThingsBoard Inc. does not store or have access to your card data.
+
+{% capture difference %}
+**Notice:** Payments are non‑refundable.
+{% endcapture %}
+{% include templates/info-banner.md content=difference %}
+
+## Accessing Plan and billing
+
+Navigate to **Plan and billing** from the main menu.
 
-Notice: payments are non-refundable.
+> This section is available to Tenant administrators only.
+
+At the top of the page, the current subscription name and status are displayed.
+
+If attention is required, warning banners may appear (for example, _"Your current plan is deprecated"_ or _"Your billing information is incomplete"_).
+Each banner contains a direct action link to resolve the issue.
 
 ## Subscription
 
-**Subscription** tab displays all details about current subscription including current subscription plan, subscription status, current subscription period, applied discount.
-**Plan details** section displays current subscription plan limits. It is also possible to view current plan usage by clicking on **Show usage** toggle. 
+The **Subscription** tab provides an overview of the current subscription and plan limits.
 
-{% include images-gallery.html imageCollection="subscription" %}
+<b><font size="4">Management</font></b>
 
-## Billing information
+The **Management** section displays:
+- **Subscription plan** – current plan name and status.
+- **Subscription period** – start and end dates of the current billing cycle.
+- **Next charge** – amount and scheduled billing date.
+
+Available actions:
+- [Update plan](#update-plan) – upgrade or change the subscription plan.
+- [Cancel subscription](/docs/{{docsPrefix}}subscriptions/#how-to-cancel-my-subscription){:target="_blank"} – cancel the active subscription.
+- **Apply coupon** – apply a valid discount coupon.
+
+<b><font size="4">Subscription plan data</font></b>
+
+This section displays plan limits and usage indicators.
+
+You can switch between:
+- **Entities & Features** – limits for entities, features, and add-ons.
+- **API calls** – monthly quotas for messages, data points, rule engine executions, and other API-related limits.
+
+Usage bars show current consumption relative to plan limits.   
+The **Add to plan (+)** action allows extending limits or enabling additional features where available.
+
+### Update plan
+
+To change the current subscription plan, click **Update plan**.
+
+<b><font size="4">Step 1: Choose the Subscription Plan</font></b>   
+At this step, all available ThingsBoard EU Cloud subscription plans are displayed. Your current plan is marked with the **Current plan** label.
+
+To select another plan, click **Select** under the required option.
+
+To update your current plan, click **Customize** under the current plan.
 
-**Billing information** tab allows managing current payment method (credit or debit card details) and billing details such as company name and billing address used for invoicing.
+<b><font size="4">Step 2: Customize</font></b>   
+In this step, you can customize the selected plan by enabling add-ons and purchasing additional resource packs.
 
-{% include images-gallery.html imageCollection="billingInfo" %}
+<b><font size="3">Add-ons</font></b>   
+Allow enabling optional features, such as: [White labeling](/docs/{{docsPrefix}}user-guide/white-labeling/){:target="_blank"}, [Edge Computing](/docs/user-guide/edge-computing/){:target="_blank"}, [Trendz Analytics](/docs/trendz/){:target="_blank"}.
+
+<b><font size="3">Top-ups</font></b>   
+Allow extending plan limits. You can switch between:
+- **Entities** – device, asset, customer, user, integration, and converter limits.
+- **API calls** – message traffic, compute, storage, alarms, and email/SMS quotas.
+
+To increase a limit, use the **+ / -** controls in the corresponding section.
+
+If additional resources require a higher plan, the wizard displays an **Update to ... plan** option.
+
+Click **Next: Summary** to proceed.
+
+<b><font size="4">Step 3: Summary</font></b>   
+The summary step displays the final subscription price.
+
+If the subscription is updated in the middle of a billing cycle, the wizard may display an additional charge after plan update.
+
+To confirm changes and apply the selected plan configuration, click **Update plan**.
+
+## Billing information
+
+The **Billing information** tab lets you manage your **payment method** and **billing details** used for invoicing.
 
 ### Payment method
 
-Allows managing current credit or debit card details. You may easily update it at any time by clicking on **Update** button.
-In order to pay with the card the ***Owner name***, ***Country***, ***Card number***, ***Expiry date*** and ***CVC*** should be populated.
+Shows the currently configured payment method. If no card is added, a warning message is displayed.
+
+To add a payment method, click **Add** and provide the card holder name, country, card number, expiry date, and CVC.    
+ThingsBoard Cloud supports both **credit and debit cards**.
+
+> All payment processing is handled securely by [Stripe](https://stripe.com/){:target="_blank"}.
 
-{% include images-gallery.html imageCollection="updatePaymentMethod" %}
+Once validated, the card becomes the active payment method for future charges.
 
 ### Billing information
 
-Consist of company contact details and billing address and is used by Stripe to generate the invoice. You may easily update this info by clicking on **Update** button.
+**Billing information** is used to generate invoices.
 
-{% include images-gallery.html imageCollection="updateBillingInfo" %}
+To update billing details, click **Update**, fill in the required fields, and save your changes.
 
 ## Invoices
 
-**Invoices** tab displays list of automatically generated invoices. All invoices are available for download in a PDF-format.
+The **Invoices** tab displays a list of all generated invoices for your subscription.
+
+Each invoice entry includes the invoice date, amount and currency, invoice number, payment type, and status.
+
+You can download invoices in PDF format or open them in a new browser tab.
 
-{% include images-gallery.html imageCollection="invoices" %}
+Invoices are generated automatically at the end of each billing cycle.
 
 ## Upcoming invoice
 
-**Upcoming invoice** tab displays upcoming invoice preview that will be generated at the beginning of the next billing cycle. 
+The **Upcoming invoice** tab shows a preview of the next invoice that will be generated.
+
+> Note: This is a preview only. The invoice is not created until the billing cycle is completed.
+
+## Audit logs
+
+The **Audit logs** tab provides a history of billing‑related actions.
+
+Audit logs help track administrative actions and support troubleshooting and compliance requirements.
 
-Note: When you are viewing an upcoming invoice, you are simply viewing a preview – the invoice has not yet been created.
+## Learn more about plans
 
-{% include images-gallery.html imageCollection="upcomingInvoice" %}
+Learn more about available subscription plans, plan limits, and included features on the [Subscription page](/docs/paas/eu/subscriptions/){:target="_blank"}.