HomeGuidesAPI ReferenceChangelog
Terms of Use
API Reference

Session / Change tariff

Change the tariff for a session and trigger recalculation of charging periods.
This action supports loyalty program integrations where discounts need to be applied mid-session.

The tariff change is only available when:

  • Billing status is NOT "Completed"
  • For running sessions: duration is under 3 hours
  • For roaming sessions (the platform as eMSP): session must be finished and have a CDR received
  • No recalculation is already in progress
  • For local charge point sessions: a StartTransaction message must exist
  • The session's billing is not owned by an upstream roaming partner (broker sessions with upstream-sourced CDRs)
  • The selected tariff already has usable concrete pricing
Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Path Params
integer
required

The ID of the session

Body Params
integer
required

The ID of the tariff to apply to the session. The tariff must already have usable concrete pricing;
unresolved markup or discount tariff definitions cannot be assigned directly and produce a tariffId validation error (422).

string
length ≤ 1000

Optionally, add a reason (e.g., wrong tariff applied at session start, billing dispute).

Responses
202

Action accepted. The tariff has been changed and charging periods are being recalculated.

Language
Credentials
URL
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json