> ## Documentation Index
> Fetch the complete documentation index at: https://docs.energy.nayax.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Configuring Taxes

Nayax Energy Core records the tax rates that apply at each of your locations, calculates how much tax is embedded in every charging session, and reports those amounts back to you by location so you can file and remit.

This guide covers how tax is configured, how tax-inclusive pricing works, what the tax reports contain, and who is responsible for remittance.

***

## At a glance

| Question | Answer |
| - | - |
| What tax types are supported? | **Sales tax** (a percentage of the session cost) and **excise tax** (a flat amount per kWh). |
| Where is tax configured? | On the **location** — during location onboarding, or any time afterward from the location page. |
| Does tax get added on top of the rate? | No. Rates are **tax-inclusive**. The tax is extracted from the amount the driver is billed. |
| Who remits the tax? | The **network**. Nayax Energy Core records and reports tax; it does not file or remit on your behalf. |
| Where do I see the numbers? | The **Tax Report** in Network Manager, the **Tax Summary Report** in Site Manager, per-session columns in the Sessions table, and driver receipts. |

***

## The two tax types

| Tax type | How it is entered | What it applies to |
| - | - | - |
| **Sales Tax** | A percentage of the total session cost (e.g. `8.25`) | Every cost component of the session — energy, time, idle fees, and flat fees. |
| **Excise Tax** | A flat amount per kWh (e.g. `0.032`) | Energy delivered only. It does not scale with time, idle, or flat charges. |

Both are optional. A location with neither configured records zero tax on its sessions.

> [!NOTE]
>
> Nayax Energy Core stores **one** sales tax rate per location. If your jurisdiction layers state, county, and city tax, enter the **combined** effective rate.

***

## Rates are tax-inclusive

The price a driver sees on the station, in the app, and at the payment terminal is the price they pay. Tax is not added at the end — it is already inside the rate.

That means the platform works **backward** from the billed total to determine how much of it was tax:

1. The flat per-kWh **excise tax** is subtracted from the total.
2. What remains is divided by `1 + sales tax rate` to recover the pre-tax amount.
3. The difference is the **sales tax**.

### Worked example

A 20 kWh session at a listed rate of **\$0.50/kWh**, at a location configured with **8.25% sales tax** and **\$0.03/kWh excise tax**:

| Line | Amount |
| - | - |
| Billed to the driver (20 kWh × \$0.50) | **\$10.00** |
| Excise tax (20 kWh × \$0.03) | \$0.60 |
| Pre-tax subtotal ((\$10.00 − \$0.60) ÷ 1.0825) | \$8.68 |
| Sales tax (\$10.00 − \$0.60 − \$8.68) | \$0.72 |
| **Total tax** | **\$1.32** |

The driver pays \$10.00 either way. What changes is how that \$10.00 is split.

### What this means for drivers

* The advertised price is the final price. There is no tax added at checkout.
* Prices are directly comparable between sites, since every listed rate already includes tax.
* Receipts still itemize the tax, so drivers can see exactly what they paid.

### What this means for network operators

Because the driver's total is fixed by your rate, **tax comes out of your revenue, not out of the driver's pocket**. The same \$0.50/kWh list price yields different net revenue depending on the tax configured at the location:

| Sales tax | Excise tax | Billed to driver (20 kWh) | Tax recorded | Your pre-tax revenue |
| - | - | - | - | - |
| — | — | \$10.00 | \$0.00 | \$10.00 |
| 8.25% | — | \$10.00 | \$0.76 | \$9.24 |
| 8.25% | \$0.03/kWh | \$10.00 | \$1.32 | \$8.68 |

> [!WARNING]
>
> Adding or increasing a tax rate does **not** increase what drivers pay — it reduces what you keep. If you need to stay whole on net revenue, raise the station's rate to match. See [Setting Rate on a Station](https://docs.energy.nayax.com/guides/set-Rate.md).

***

## Setting tax rates

Tax rates are set on the **location**, and apply to every station at that location.

### During location onboarding

The **Tax Information** section appears in the new location form, alongside site information and contact details. You can leave it blank and add the rates later.

### On an existing location

**1. Open the location**

In **Network Manager**, go to **Locations** and select the location.

**2. Find the Tax Information card**

Scroll to the **Tax Information** card on the location page.

**3. Edit the rates**

Click **Edit** and enter the rates.

| Field | Format | Example |
| - | - | - |
| **Sales Tax (% of total cost)** | A percentage, up to 2 decimal places | `8.25` |
| **Excise Tax (flat fee per kWh)** | An amount in dollars per kWh, up to 4 decimal places | `0.032` |

**4. Save**

Save your changes. The card shows the saved rates as `8.25%` and `$0.0320/kWh`. A field left blank or set to zero displays as `-`, and no tax of that type is recorded.

### Via the API

Tax rates can also be set when creating or updating a location through the **Asset Management API**, using the `taxConfig` object on the location.

| Field | Format |
| - | - |
| `totalPercentSalesTax` | A decimal fraction between `0` and `1` — `0.0825` is 8.25% |
| `energyPerKwhExciseTax` | Currency per kWh — `0.032` is \$0.032/kWh |

> [!NOTE]
>
> The API takes the sales tax as a **decimal fraction**, while Network Manager takes it as a **percentage**. `8.25` in the UI is `0.0825` in the API.

### When a rate change takes effect

Tax is calculated once, when a session's payment is recorded, using the rates in effect at that moment. Each session keeps a snapshot of the rates it was calculated with.

* **New rates apply to sessions that complete after the change.**
* **Sessions that already completed are never recalculated.** A report re-run for a past period returns the same figures it did before.

If a location was configured with the wrong rate and past sessions need correcting, contact Nayax Energy Core support.

***

## Who remits the tax

**Remitting tax is the responsibility of the network.**

Nayax Energy Core calculates the tax embedded in each session and reports it. It does not file returns, register you with tax authorities, or remit funds on your behalf. The figures in the tax reports reflect only the tax included in the amounts billed to drivers.

Where liability actually sits between the network, the site host, and any other party depends on your commercial agreement and on the rules of the jurisdiction. Both the Network Manager and Site Manager reports carry a disclaimer to this effect.

> [!NOTE]
>
> Site hosts see the same tax figures for their own locations in Site Manager, but the report they receive does not account for fees collected by the network — their final payout can differ from the amounts shown.

***

## Reporting

### Tax Report (Network Manager)

Go to **Settings → Tax Reports**.

Choose a **Start Date** and an **End Date**, then click **Generate Report**. The report is generated in the background and emailed to you as a CSV, usually within a few minutes. The download link in the email is valid for **6 hours**.

> [!NOTE]
>
> The **start date is inclusive and the end date is exclusive**. To cover the month of March, use a start of March 1 and an end of April 1.

The report covers every location in your network.

**One row per location, per currency**, ordered by state and then location name:

| Column | What it contains |
| - | - |
| `state` | The state the location is in. |
| `location_id` | The location's identifier in Nayax Energy Core. |
| `location_name` | The location's display name. |
| `street_address`, `city`, `zip` | The location's address, for jurisdiction-level filing. |
| `currency` | The currency of the sessions in this row. |
| `session_count` | Number of collected session payments in the period. |
| `pre_tax_subtotal` | Total session revenue with tax removed. |
| `sales_tax` | Total sales tax embedded in the billed amounts. |
| `excise_tax` | Total per-kWh excise tax on energy delivered. |
| `total_tax` | `sales_tax` + `excise_tax`. |
| `guest_charging_fees` | Guest charging fees collected. These are **not** taxed — see below. |
| `billed_total` | Total amount billed to drivers, tax included. |

If there is no activity in the period, the report is delivered with headers and no rows.

> [!NOTE]
>
> If a driver is refunded after the fact, that session still appears in the report with its full billed amount and tax.

### Tax Summary Report (Site Manager)

Site hosts generate the same report for their own locations from the **Reports** page in Site Manager, under **Tax Summary Report**. It is scoped to the locations tied to their Site Partner and is emailed to the requesting user.

### Per-session detail

When you need to see tax on an individual session rather than a location total:

| Where | What it shows |
| - | - |
| **Network Manager → Sessions** | **Sales Tax** and **Excise Tax** columns showing both the amount and the rate that was applied. Included in the CSV export as `Sales Tax (%)`, `Sales Tax Amount (USD)`, `Excise Tax (USD/kWh)`, and `Excise Tax Amount (USD)`. |
| **Site Manager → Session Summary report** | Per-session `Sales Tax Rate`, `Sales Tax Amount`, `Excise Tax Rate`, and `Excise Tax Amount`. |
| **Driver receipts** | Itemized pre-tax line items, a **Sales tax** line showing the percentage applied, an **Energy excise tax** line, and a **Total incl. tax**. |

***

## How specific cases are handled

**Guest charging fees are not taxed.** The guest charging fee is added after tax is calculated and is reported in its own column, separate from the taxable session cost.

**Discounts reduce the taxable amount.** A driver discount is applied to the pre-tax charge, and sales tax is calculated on the discounted amount. Excise tax is a flat per-kWh charge and does not scale with a discount.

**Free and fully discounted sessions still record excise tax.** Excise is calculated from energy delivered, so a session where the driver was billed nothing can still carry an excise amount — it appears in the `excise_tax` column with no corresponding billed revenue.

**In-progress sessions show estimates.** Costs displayed while a session is running are estimates. Discounts, taxes, and other adjustments are applied shortly after the session completes and its payment is recorded.

**Only collected payments are counted.** The tax report includes sessions whose payment status is collected.

**Multiple currencies are reported separately.** A location with sessions in more than one currency produces one row per currency.

**Locations with no tax configured** record zero tax, and their pre-tax subtotal equals the billed total.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.