Skip to main content
A voucher is a code that gives a chosen group of drivers access to selected locations, at a price you set.
The Voucher and Discounts screen in the Spirii app, with a voucher code typed into the field and a Redeem voucher button below it

Overview

A voucher does two things at once:

Access

Grants a chosen group of drivers access to a set of locations.

Pricing

Sets what those drivers pay at the locations it covers.
An operator uses it to open their chargers to a known audience (fleet drivers, employees, residents, VIPs) on terms that don’t touch the public price.
A voucher overrides the location’s standard tariff. While it’s active, the holder pays the voucher price, not the public price, at every location attached to it.
A voucher can also reveal locations that aren’t on the public network at all, so it doubles as a way to keep a set of chargers private to the group that holds the code. Treat the access as the primary job and the price as a setting on top: the cleanest setup links the voucher to a tariff for pricing, so the voucher controls who and where, and the tariff controls how much.

Context

Vouchers are an operator’s tool, and they work only within Spirii’s own mobility surfaces. A CPO creates and manages them in Connect for their own locations, and a driver redeems a voucher in Spirii Go or a branded app. A voucher can also be linked to a Spirii token, so the token itself carries the access. Vouchers aren’t shared with external eMSPs and don’t travel over roaming; they grant access on the Spirii network only.

Key attributes

A voucher has two levels: the voucher group that sets the terms, and the vouchers — the codes issued under it.

Voucher group

Voucher

Relationships

Vouchers, app users, and tokens

A redeemed voucher doesn’t stand on its own; it connects to the things that carry its benefit, and the link between the three is worth getting straight:
  • A voucher links directly to the app users who redeem its code. Entering the code attaches that app user to the voucher (up to its max-users limit), which is what applies the access and price to their account.
  • A voucher can also be linked to a token, granting that token the same access and pricing benefits, so a driver charging with the token gets the voucher’s locations and price without entering the code in an app.
The same voucher therefore reaches a driver two ways: through the app user who redeemed the code, or through a token it’s linked to.

Used in

Voucher access

Create voucher groups, issue codes, and open locations to a user group.

Tariffs

The price a voucher should link to.

Locations

The sites a voucher grants access to.

Tokens

A voucher can be linked to a token to carry its access.