Skip to main content

EV Pass

The EV Pass is Rollyy's driver identity and wallet system. It gives users a rolo_id — a persistent identity used across charging sessions, payments, and history.

Authentication​

EV Pass endpoints use User JWT authentication:

Authorization: Bearer <user_jwt>

Obtain a JWT via the Authentication flow.

EV Pass Identity​

Get EV Pass​

Returns the current user's EV Pass profile and active session summary.

Endpoint: GET /v1/id/ev-pass

Auth: User JWT

Response:

{
  "rolo_id": "ROLO-A1B2C3D4",
  "name": "John Doe",
  "email": "john@example.com",
  "wallet_balance": 25.00,
  "currency": "EUR",
  "active_sessions": 0,
  "total_sessions": 14,
  "total_energy_kwh": 312.5
}

Session History​

Get charging and parking history​

Returns unified history of charging sessions and parking bookings for the authenticated user.

Endpoint: GET /v1/id/history

Auth: User JWT

Query parameters:

  • limit — number of records (default: 20)
  • skip — pagination offset

Response:

[
  {
    "type": "charging",
    "session_id": "770e8400-e29b-41d4-a716-446655440002",
    "status": "completed",
    "energy_kwh": 20.0,
    "cost": 7.20,
    "currency": "EUR",
    "duration_minutes": 30,
    "start_time": "2026-03-29T10:00:00Z",
    "end_time": "2026-03-29T10:30:00Z"
  },
  {
    "type": "parking",
    "booking_id": "booking_abc123",
    "status": "completed",
    "start_time": "2026-03-28T09:00:00Z",
    "end_time": "2026-03-28T11:00:00Z",
    "cost": 4.00,
    "currency": "EUR"
  }
]

Nearby Chargers​

Find chargers near the user​

Endpoint: GET /v1/id/nearby

Auth: User JWT

Query parameters:

  • lat — latitude
  • lng — longitude
  • radius_meters — search radius (default: 2000)

Response:

[
  {
    "rollyy_id": "charger_001",
    "evse_id": "FI-VRT-E12345",
    "network": "Virta",
    "connectors": [
      {
        "standard": "CCS",
        "power_kw": 150
      }
    ],
    "status": "AVAILABLE",
    "distance_meters": 320
  }
]

Wallet​

Get wallet balance​

Endpoint: GET /v1/wallet/balance

Auth: User JWT

Response:

{
  "balance": 25.00,
  "currency": "EUR",
  "rolo_id": "ROLO-A1B2C3D4"
}

Top up wallet​

Endpoint: POST /v1/wallet/topup

Auth: User JWT

Request:

{
  "amount": 20.00,
  "currency": "EUR",
  "payment_method_id": "pm_stripe_xxx"
}

Response:

{
  "success": true,
  "new_balance": 45.00,
  "currency": "EUR",
  "transaction_id": "pi_stripe_xxx"
}

Session Receipt​

Get a receipt for a completed charging session.

Endpoint: GET /v1/sessions/{session_id}/receipt

Auth: User JWT

Response:

{
  "session_id": "770e8400-...",
  "rolo_id": "ROLO-A1B2C3D4",
  "network": "Virta",
  "evse_id": "FI-VRT-E12345",
  "start_time": "2026-03-29T10:00:00Z",
  "end_time": "2026-03-29T10:30:00Z",
  "energy_kwh": 20.0,
  "duration_minutes": 30,
  "cost": 7.20,
  "currency": "EUR",
  "payment_status": "paid",
  "stripe_payment_intent_id": "pi_xxx"
}