Sessions and states

A session (ses_…) is one charge from payment or authorisation to settlement. It belongs to exactly one charge point and freezes the current tariff version at the start. Later tariff changes do not affect running sessions.

Flow

1. The driver scans the QR code or selects the charge point on the terminal. Ladehase creates a session (created).
2. They reserve an amount or buy a package (awaiting_payment).
3. Once the payment is authorised (authorized), Ladehase releases the charge point and waits for the car (waiting_for_vehicle).
4. The car charges (charging). Ladehase measures the energy and projects the amount.
5. The cable is unplugged or charging is stopped (completed).
6. Ladehase captures the final amount, releases the rest of the reservation and issues the receipt (settled).

States

State	Meaning
created	Session created, no payment yet.
awaiting_payment	Payment in progress at the payment partner.
authorized	Paid or released through an access grant.
waiting_for_vehicle	Charge point released, car not plugged in or not charging yet.
charging	The car is charging.
suspended	Charging paused, for example by the car or load management.
idle	Car full, cable still plugged in. An idle fee may apply here.
stopping	Stop requested, Ladehase waits for the charging station to confirm.
completed	Charging finished, settlement follows.
settled	Settled. Final state.
payment_failed	Payment failed. Final state.
expired	No car plugged in within the time limit, reservation released. Final state.
canceled	Cancelled, reservation released. Final state.
error	Fault. Either resolved (on to completed) or cancelled (canceled).

There is at most one active session per connector. A second request for the same connector returns 409 with the code conflict.

Stop reasons

The stop_reason field tells you why charging ended:

• unplugged: cable unplugged
• amount_reached: reservation reached (minus safety margin)
• package_reached: package used up
• driver: ended by the driver
• operator: ended by the operator
• api: ended through the API
• max_duration: maximum duration reached
• device_error: fault at the charging station

Billing modes

The mode field shows how the session is billed:

• reservation: reserve an amount, capture by consumption, release the rest.
• prepaid: package paid in advance. Unused credit is refunded or forfeited depending on the setting.
• access: charging through an access grant, free or at a special tariff.

Session amounts

Field	Meaning
authorized_amount	Reserved or prepaid amount in Rappen.
amount	Projected running amount or final amount in Rappen.
captured_amount	Amount actually captured in Rappen.
refunded_amount	Refunded amount in Rappen.
vat_amount	Included VAT in Rappen.
energy_wh	Energy charged in watt hours.

GET /v1/sessions/{id}/events returns the session timeline with all events.