Improve this doc

Billing

Billing in balenaCloud is managed through organizations. To manage billing for a specific organization, navigate to the organization and select the Billing tab from the sidebar on the left:

From this dashboard, you can change your billing plan, update your billing information, monitor your usage, and download invoices. If you have any questions about billing for your account, please contact our customer success team.

Changing your billing plan

To modify or upgrade your billing plan, click the "Change plan" button on the billing page:

Select the plan you'd like to upgrade to from the list of available options:

Enter your billing information and complete the signup process:

If you need to downgrade or cancel your plan, you can follow the steps mentioned above by choosing a lower tier or free plan instead.

Certain plans may require you to contact our customer success team in order to complete an upgrade or downgrade. If you find yourself in this situation, please contact our customer success team.

Account settings and usage

At the top of the billing page, you'll find a summary of your subscription with information on the total amount and due date for your next payment:

Beneath this you can see your current usage, including active devices and collaborators:

Further down, you'll find a place to download invoices, add or edit payment methods, and update account information:

At the bottom of this page, you'll find more information on the available plans, and you can change plans as necessary.

Credits

To enable customers to drive down their device usage costs, balena has an optional credit-based purchasing model available. A credit represents a pre-purchased unit that corresponds to the usage of one device exceeding plan allowance for one month. At the end of each monthly billing cycle, any available credits are used first before a dynamic charge is initiated. This system is available for all non-Prototype customers.

Credit purchases of any size will result in paying less for device usage on the platform. The greater your volume in a single purchase, the lower your per-credit cost will be. The discount computation also takes into account the previously purchased credits that haven't been used. This means that you can continue to "top off" your credits to maintain better discounts. To estimate credit costs, head over to the Paying With Credits section of our pricing page.

To manage credits, navigate to the organization and select the Credits tab from the sidebar on the left:

On the Credits page, you're able to see credit purchase history and the number of credits that have been purchased and are still allocatable for device usage. This is also where you can initiate credit purchases. An invoice will be automatically generated and listed on the Billing page when a credit purchase is initiated.

Note: Unused credits will expire 10 years after the date of purchase. If there is no activity for 2 years we may at our discretion cancel any outstanding credits and will provide 60 days notice to the customer of our intention to do so. Credit purchases are non-refundable and cannot be refunded due to project or plan cancellation. Credits are also non-transferrable between organizations. Credits only apply to Microservices fleet types and must be purchased at least 24 hours before your monthly billing renewal date.

Dynamic billing

Any usage above what is included in your current billing plan or covered by credits will be tracked and billed dynamically in arrears. Dynamic billing will occur every month, even for those on annual plans.

For both devices and users, usage is calculated based on the maximum number in your account at any point during the month after any available credits have been used. This includes all active devices, whether online or offline.

As an example, let's say you are on the Pilot plan, which includes up to 50 devices and 3 users. In one month, your active device count steadily climbs from 43 to 52. During this same month, you temporarily increase your user count from 3 to 4, before returning it to 3 at the end of the month. Based on this usage, your dynamic billing charges for the month will include an additional 2 devices and 1 user.

Furthermore, we charge a device or user only once for the most feature-rich usage tier within the same billing period. For example, a user was assigned a Developer role for the first half of the billing period and was later reassigned the Operator role for the second half of the billing period. In this scenario, we would charge the usage as a Developer role for the entire billing period. This is because the Developer role is a more feature-rich usage tier than the Operator role, as seen in fleet membership types. It's important to note that we are not double charging for the same user.

Charges for usage outside your plan will show up under the Add-ons section of your invoice. If you prefer, you can still contact us to pre-purchase users and have them added to your plan, rather than be automatically billed in arrears for additional devices and users. To pre-purchase devices, consider using credits.

Inactive devices

If you have devices that will be inactive for long periods of time, you can mark them as Inactive. This will keep them from being counted towards your device total. We’ll charge a one-time deactivation fee, and the devices will remain inactive until they come online.

Marking a device as Inactive is a device setting. Device operations can be applied in one of three ways: as a group operation applied to one or more devices in the device list, as an operation selected from the dropdown on the device dashboard, or directly from the Settings tab of the device dashboard. Once a device has been marked Inactive, it will be faded out in the device list.

Inactive vs Offline Devices

To understand the difference between inactive and offline devices, we define them in the following ways:

  • Inactive: The device has been either deactivated or preregistered but hasn't connected to the balenaCloud API yet.
  • Offline: The device is not connected to cloudlink and didn't have any recent API communications.

If you have a device offline and active, you will still be billed for that device. Those devices are usually still deployed in the field and ready to be used at any time. If you make the decision to have your devices offline intentionally, you will still be able see them in your fleet and can take some actions such as applying updates, that will take effect as soon as they come online.

Once you deactivate a device, you will not be able to monitor nor apply updates to that device. After the de-activation fee is charged, you won't be charged again until the device comes back online.

Device Freezing

In the event that your balena invoices are overdue, all devices under that organization in the balenaCloud dashboard may be "frozen". Frozen devices will continue to run their application containers as usual, but users will no longer be able to access or manage those devices from the dashboard until the overdue invoices are paid and the devices are unfrozen. Frozen devices are indicated by a snowflake icon in the dashboard.

Users can determine which invoices are overdue under their organization's billing page. To settle overdue payments, update your payment method or contact the customer success team at solutions@balena.io.