API Reference

Start a remote charging session

post
https://{environment}.plugsurfing.com/drive/v1/users//sessions/start

Start a remote charging session. Important implementation details:

  1. Only chargers with REMOTE_START_STOP_CAPABLE capability can be used
  2. Allow up to 2 minutes for session to transition from WAITING_TO_START to STARTED
  3. Wait at least 1 minute before retrying failed starts
  4. Multiple ongoing sessions are possible
  5. Subsequent start requests within 60 seconds on same connector are blocked
  6. Session events will notify about session status changes
  7. If a user has CREDIT_CARD payment method, and 3DS challenge mode is set to CHALLENGE, then threeDSClientSecret might be present instead of sessionId, which your frontend needs to prompt the user to sign. After the user successfully signs the challenge, do a second start request!
Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Path Params
string
required

The unique identifier of the user who will own the charging session

Body Params

request

Request payload to start a charging session remotely.

string
required

Connector identifier to start charging on.

Responses

Updated 2 months ago

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

Updated 2 months ago