Skip to main content
Pricing options and logic is how you build what a driver pays to charge: a fixed or dynamic base price, conditional fees layered on top, and a separate price for roaming.
The tariff editor in Spirii Connect, showing dynamic base details with a minimum fee alongside a conditional markup fee limited to set times and days

​
Overview

A tariff composes a price from two parts: a base fee that always applies, and optional conditional fees that take over when their conditions are met. You build it once and apply it to as many locations as you like. Separately, you set a roaming tariff — the price external networks are billed when their drivers charge at your locations.

​
How it works

​
The base fee

Every tariff starts with a base fee, in one of two modes:

Fixed

A set price per kWh or per minute that doesn’t change.

Dynamic

The hourly spot price for a power grid zone, with your markup on top.
Fixed keeps the price predictable; dynamic lets it track your wholesale electricity cost through the day.
For dynamic, a minimum fee acts as the floor and the fallback if spot data drops too low or goes missing.

​
Conditional fees

On top of the base, you can add conditional fees that apply only when their conditions are met:

Energy fee

Per kWh — on a dynamic tariff, this is the markup over spot.

Time fee

Per minute — charged per minute of the session.

Flat fee

Per session — a one-time charge.
Each fee can be limited to specific timeslots and days, or set to apply only after a session has run for a set time — counting both active charging and idle time once the car is full.

​
How fees resolve

When fees overlap, two rules keep the price predictable:
  • Fees are read top to bottom, so their order matters. A fee with a longer delay should sit above one with a shorter delay, since the shorter delay is reached first.
  • If two fees of the same type have overlapping conditions, only the top-most applies — so a session is never charged twice for the same thing.
Every price is shown to the driver gross, including VAT.

​
Common pricing patterns

A few patterns cover most needs:
Set the base fee to your lowest (night) rate, then add energy fees for the daytime and peak periods using timeslots — mirroring how electricity costs rise and fall through the day.
Add a time fee that switches on after, say, 180 minutes, so a driver who’s finished charging is nudged to move on. Limit it to the hours where it matters; the driver is warned in the app before it starts.
Stack time fees with increasing apply-after delays — for example free for the first hour, a per-minute fee after 60 minutes, and a higher one after 120 — to keep a busy site turning over.
Add a flat fee, at the start or after a delay, where a one-time charge fits the model.

​
Roaming pricing

The price you set toward external networks is separate from your tariff, and simpler. You set a roaming tariff per location — a single flat rate per kWh, chosen from a pre-made list rather than built from scratch:
  • You enter it gross (including VAT for the location’s country) so it’s comparable with your tariff, but eMSPs are billed the net amount. A 1.00 € roaming tariff in a country with 25% VAT reaches the eMSP as 0.80 €.
  • Changes take effect at midnight; until then the current roaming tariff stands. Selecting No Roaming turns it off for the location.
  • Roaming partners add their own margin on top, so a driver arriving over roaming may see a higher price than your roaming tariff.

​
Set up

Build tariffs under Tariffs in Connect — set the name, currency, and base fee, add any conditional fees, then bind the tariff to your locations. Set the roaming tariff separately, on each location. A tariff applies the moment it’s bound; a roaming tariff change applies at the next midnight.

​
Dependencies & limitations

  • Tariffs apply within Spirii’s own surfaces — Spirii Go, branded apps, Spirii tokens, and Spirii POS. External networks receive the roaming tariff instead.
  • The roaming tariff is a flat per-kWh price only, billed net to eMSPs, effective at midnight, with partner margin added on top.

Tariffs

The tariff object this builds on.

Roaming connection

How the roaming tariff reaches external networks.

Locations

Tariffs and roaming tariffs are applied per location.

Sessions and CDRs

Where the price a tariff produced is recorded.