Skip to main content
When a client session is for one of your users (external_user_id), their first link session starts with a consent screen. It tells them that you use Plugchoice to connect to their chargers, and what you may do:
  • You can see their chargers, their status and their charging sessions.
  • You can control their chargers: start, stop and limit charging, and change their settings.
  • They can disconnect at any time in your app.
It links to Plugchoice’s privacy policy and to yours.
  • Agree and continue records the consent and goes on.
  • Not now ends the link session: it is abandoned with abandon_reason: consent_declined, and your app gets cancelled.
  • A user who agreed once isn’t asked again in later link sessions with your integration, until the consent text changes.
  • Your own chargers (no external_user_id) and Plugchoice users’ own link sessions have no consent screen.
The consent covers reading and controlling the charger from the start, so features that control charging later don’t need to ask your users again.

​
Your branding

Link shows your brand wherever your users see it:
Plugchoice sets these on your integration. Email them to support@plugchoice.com: your name as your users know it, a logo (an HTTPS URL), an accent colour as #RRGGBB, and your privacy policy URL. Without an accent colour Link uses its own.

​
Light, dark and language

Each client session sets:
  • color_scheme: light, dark, or system (the default), which follows the phone. Send the one your app uses, so Link matches it.
  • language: de, en, es, fi, fr, nl or zh. Other languages fall back to English.
See Client sessions and scopes.