# How to manage clients' bills

{% hint style="success" %}
To be able to work with bills, your plan must be **Core, Scale** or **Enterprise solution.**
{% endhint %}

{% hint style="success" %}
In **Roles** → **Clients' Permissions**, admins control access by setting permissions for **editing** bills' info, ensuring only authorized users can manage this data. All bill-related changes are logged. Access them via the **View logs** next to the client.
{% endhint %}

## Client's billing overview

Bills are generated automatically each month if the client has active miners. There are two ways to view bill information:

* Go to the **Clients** section in the header and select **Billing** from the dropdown menu.
* Click the number in the **“Bills”** column for the desired client — this will open the **Bills** page filtered by that client.

The **Bills** page includes the following fields:

1. **Bill ID** — unique identifier of the record.
2. **Period** — the month the bill was issued for.
3. **Client** — the client the bill is issued to.
4. **Facility** — the farm associated with the bill.
5. **Status** — current bill status (e.g., *Unpaid* or *Paid*), including payment sub-statuses such as *Partially Paid* or *Overpaid*.
6. **Payment Method** — bank transfer, cryptocurrency, card, etc.
7. **Currency** — the currency in which the bill is issued.
8. **Consumption** — total monthly energy consumption of all client miners at the selected facility.
9. **Pricing** — electricity price.
10. **Hosting** — includes electricity cost plus a markup for hosting services.
11. **Service Cost** — additional expenses, such as equipment repairs.
12. **Total** — total amount due for the selected period.
13. **Payment info** — amount and date of received payments. If there is no payment or the bill is partially paid, a tooltip will display an **Add Payment** button on hover.
14. **Actions** — options to edit or download bill information.

<figure><img src="/files/4QE64iporZmKxBJZJt2X" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/NnlQL13b12MlojI5eIvN" alt=""><figcaption></figcaption></figure>

## Setting currency for client bills

1. Click the **Settings** icon above the table.
2. In the Settings section, choose the currency for billing all clients.

<figure><img src="/files/kLhCq1Yp02OZH8xRf3ty" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/y2MofQjQaWz8gNpNEFVT" alt=""><figcaption></figcaption></figure>

## How to add payment

1. Go to **Billing.**
2. Click **Add Payment for required bill.**
3. Enter information such as payment amount, date, and method.
4. Click **Apply.**

<figure><img src="/files/6psbfqQUu4u4uTmosONA" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/W2ywYN8Byksr1osANvVy" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
By clicking **Apply**, the bill's status updates: if the payment covers or exceeds the total bill amount, the status automatically changes from unpaid to paid.
{% endhint %}

## How to edit bill

1. Go to **Billing.**
2. Click the single-action button next to the desired bill and select **Edit**.
3. Edit information such as pricing, hosting markup percentage, or service cost.
4. Click **Apply**

<figure><img src="/files/4gmzhJXBT9vaZZUZoSJP" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/GpVNLVJzlozA8VnL4q0N" alt=""><figcaption></figcaption></figure>

## Billing process overview

To ensure smooth processing, follow these steps in managing client bills:

1. **Generate Bills**: Initiated automatically each month on the 1st, contingent on the presence of active miners.
2. **Review and Edit Bills**: Use the "Edit" action to update billing details as needed.
3. **Track Payment**: Monitor the status and update payments using the "Add Payment" button for unpaid bills.
4. **Log Changes**: Access the bill change logs for accurate record keeping and auditing. Go to clients'list to see logs.&#x20;

Following these procedures will help maintain accurate billing records and facilitate timely payments from clients.

## Downloading bill data

When you click "Download," the file will be saved in Excel format with the following parameters:

1. Facility
2. Index
3. SN
4. Model
5. Submodel
6. Efficiency (J/TH)
7. Uptime (hours)
8. Total Consumption (kWh)
9. Tariff (currency/kWh)
10. Cost (currency)
11. Currency

<figure><img src="/files/GMgHfpQeXh2uGnUwMwds" alt=""><figcaption></figcaption></figure>

## How is electricity consumption calculated for each client?

Based on data collected from devices every 5 seconds, the system calculates the average hashrate over 10-minute intervals. Then, taking into account the model and energy efficiency of the equipment, the platform converts these values into units of energy consumption.

## FAQ

<details>

<summary><strong>What is the billing section for?</strong></summary>

The billing section allows you to track and manage invoices for your clients based on their device usage, electricity consumption, hosting fees, or any other charges you configure.

</details>

<details>

<summary><strong>How do I create a new bill for a client?</strong></summary>

MoonOne generate bills automatically based on client-linked devices and usage stats.&#x20;

</details>

<details>

<summary>What types of charges can I include in a bill?</summary>

You can include:

* **Electricity pricing** (based on kWh rates)
* **Hosting** **markup percentage** (%)
* **Service cost** (e.g., repairs, setup fees)

</details>

<details>

<summary><strong>How do I mark a bill as paid?</strong></summary>

Open the list of client's bills and click **Add payment**, then add payment details (amount, date, method). This helps track balances and history.

If the payment covers or exceeds the total bill amount, the status automatically changes from unpaid to paid.

</details>

<details>

<summary><strong>How do I view a client's billing history?</strong></summary>

Go to the client’s profile and open the **Billing** tab. You’ll see a list of all invoices with statuses (Paid, Unpaid).

</details>

<details>

<summary><strong>Can I export bills?</strong></summary>

Yes, open any client's list of bills and use the **Download**.

</details>

<details>

<summary><strong>How are electricity fees calculated?</strong></summary>

Electricity can be billed per miner's using:

* **Estimated consumption** from miners&#x20;
* **Flat rates** per kWh /month

</details>

<details>

<summary><strong>What currencies are supported?</strong></summary>

MoonOne supports multiple currencies - USD, EUR, RUB. You can set your default in **Settings > Bills**.

</details>

***

#### We're always available! <a href="#were-always-available" id="were-always-available"></a>

Chat with us on [Telegram](https://t.me/moondmc_bot).


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://help.moonone.online/how-to-manage-clients-bills.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.