Skip to main content
POST
Start a remote session

Authorizations

X-API-Key
string
header
required

API key for authentication

Body

application/json

EMP session start request identifying connector and charging key.

connectorId
string
required

Connector identifier to start charging on.

Example:

"aHeS4zN1UjzJf/HVDH66SbaItXqHvfLxexulktxTqJavgcbozuV9KJGqNYjmaQPwTb4Ck9wTZcWeEdfeco1srw=="

keyIdentifier
string
required

Charging key identifier used for authorization.

Example:

"BnZd3qp87z"

Response

OK

SessionId will always be present, unless CREDIT_CARD reservation for a user is required during authentication, then either sessionId or threeDSClientSecret will be present.

sessionId
string

This session id should be stored and used in other endpoints.

Example:

"AAdmD55q8Vz"

threeDSClientSecret
string

Will only be available for users with CREDIT_CARD payment methods, when CHALLENGE mode has been enabled for 3DS challenges. The 3DS client secret can be used to complete a payment from your frontend. If not present, no user authentication is required to start the session.

Example:

"pi_3MtwBwLkdIwHu8ix28v3tqPa_secret_YrKJUkribcBjcG7HVhfZluoGH"