Adds EV charging to apps with a full-screen flow for station discovery, booking, payments, live charging control and history; uses backend-issued bootstrap tokens for secure user access.
Add EV charging to your Android or iOS app. The SDK opens a full-screen experience for finding stations, booking, payment, charging, and history.
Android apps without an existing 2GIS integration can install from Maven Central:
implementation("gg.team.energy:sdk-energy:0.1.7")If your Android app already has a compatible 2GIS runtime, choose the external-map artifact.
Requires iOS 16 or later.
https://github.com/gg-energy/gg-energy-sdk.git.Info.plist (example).import GGEnergyKit
try GGEnergySdk.open(
from: viewController,
bootstrapToken: bootstrapToken
)Xcode downloads the SDK and checks its checksum automatically. See the iOS guide if your app already uses 2GIS or needs local dependencies.
Your backend calls this API for an authenticated user. Keep client_secret on
your server; never put it in the mobile app.
POST https://energy-ocpi.team.gg/sdk/bootstrap
Content-Type: application/json{
"client_id": "<your-client-id>",
"client_secret": "<your-client-secret>",
"external_user_id": "<external-user-id>"
}external_user_id is the signed-in user's stable, unique ID in your system.
Derive it from the authenticated server session; do not trust a user ID supplied
by the mobile app. The response contains a one-time token:
{
"bootstrap_token": "<bootstrap-token>"
}Return the token to the app and open the SDK with it: Android launch example · iOS launch example. Request a new token for every launch; do not store or log it. Your app must authenticate the user, and only your backend may use the partner credentials. See Backend integration for failure handling.
Add EV charging to your Android or iOS app. The SDK opens a full-screen experience for finding stations, booking, payment, charging, and history.
Android apps without an existing 2GIS integration can install from Maven Central:
implementation("gg.team.energy:sdk-energy:0.1.7")If your Android app already has a compatible 2GIS runtime, choose the external-map artifact.
Requires iOS 16 or later.
https://github.com/gg-energy/gg-energy-sdk.git.Info.plist (example).import GGEnergyKit
try GGEnergySdk.open(
from: viewController,
bootstrapToken: bootstrapToken
)Xcode downloads the SDK and checks its checksum automatically. See the iOS guide if your app already uses 2GIS or needs local dependencies.
Your backend calls this API for an authenticated user. Keep client_secret on
your server; never put it in the mobile app.
POST https://energy-ocpi.team.gg/sdk/bootstrap
Content-Type: application/json{
"client_id": "<your-client-id>",
"client_secret": "<your-client-secret>",
"external_user_id": "<external-user-id>"
}external_user_id is the signed-in user's stable, unique ID in your system.
Derive it from the authenticated server session; do not trust a user ID supplied
by the mobile app. The response contains a one-time token:
{
"bootstrap_token": "<bootstrap-token>"
}Return the token to the app and open the SDK with it: Android launch example · iOS launch example. Request a new token for every launch; do not store or log it. Your app must authenticate the user, and only your backend may use the partner credentials. See Backend integration for failure handling.