Pricing and discounts

Pricing is at the core of your EV charging business—whether you're attracting new drivers to your public chargers or offering tailored discounts for trusted partners and employees.

In Spirii’s platform, charge point operators (CPOs) can define charging conditions using two pricing models:

• Tariffs: Used to define public-facing pricing for any EV driver.
• Voucher Groups: Used to define custom pricing for specific users (e.g., employees, fleets, VIPs, guests), accessible only via activation of a voucher code.

Both tariffs and voucher groups can be applied to multiple locations, enabling efficient pricing management across your network.

Key endpoints

Retrieving Tariffs

The GET Tariff endpoint returns structured tariff data, modeled on the OCPI standard. A tariff includes one or more pricing elements, each defined by:

• priceComponent (the type (e.g., ENERGY, TIME, or FLAT) and the associated gross price
• restrictions (conditions under which the price component is active (e.g., time of day, day of week, or connector type)

Only one pricing element can be active at a time. The platform evaluates tariff elements top-down and selects the first one with valid restrictions.

Retrieving Voucher Groups

The GET Voucher Groups endpoint returns data about closed user group pricing schemes.

A voucher group contains multiple vouchers (codes) that drivers can activate in the Spirii charging app to unlock access to specific prices and locations.

Key data fields include:

• perkWh (the gross price per kWh (if using fixed pricing))
• currency (the currency used)
• isSpotPriceBased (boolean indicating dynamic spot pricing)
• spotPriceMargin (gross markup added to the raw electricity market price)
• spotPriceMinimum (gross minimum price applied when market price is lower).
• voucherCount (number of voucher codes associated with the group)

Note: This endpoint is only available via the legacy API, and does not support voucher groups of the type tariff.

Next steps

By leveraging Spirii’s Tariffs and Voucher Groups endpoints, you can offer the right price to the right driver—whether you’re targeting the mass market or offering exclusive perks to partners.

Build seamless experiences with dynamic, transparent, and flexible pricing models directly integrated into your own backend systems, dashboards, or user apps.