Confirm Session Payment
POST/v1/sessions/confirm
The manual-charger counterpart to Start Charge Session. A manual charger has no hardware telemetry to price a quote from, so an on-site operator sends one instead — call this once you know that price (from a charge.quoted webhook, see Webhooks) to debit the driver's sub-wallet and authorize the session to start. Don't call Start Charge Session for a manual charger — it's automated-chargers-only.
Auth
Authorization: Bearer <driver token> — the same token used for Quote Charge Session.
Request parameters
| Field | Type | Required | Description |
|---|---|---|---|
sessionId | string | Yes | Returned by Quote Charge Session when a manual charger's response has awaitingOperatorQuote: true. |
driverEmail | string | Yes | Must match the email your driver token was minted for. |
amount | number | Yes | NGN amount to debit — cannot exceed the quotedAmount from the charge.quoted webhook. |
Example request
curl https://api.lotgrids.com/v1/sessions/confirm \
-X POST \
-H "Authorization: Bearer eyJhbGciOiJIUzI1NiIs..." \
-H "Content-Type: application/json" \
-d '{
"sessionId": "sess_9f3ac2e1",
"driverEmail": "adaeze.driver@fleetco.com",
"amount": 7500
}'
Example success response
200 OK
{
"sessionId": "sess_9f3ac2e1",
"status": "active",
"confirmedAmount": 7500,
"remainingBalance": 4500
}
A quoted session expires 5 minutes after the operator sends the quote (the same moment the charge.quoted webhook fires). Call this promptly — after expiry, this returns session_not_quoted and the driver has to start over from Quote Charge Session.
This debits the driver's sub-wallet and authorizes the charger — it does not mean charging has actually started. The on-site operator still has to tap "Start Charging" once they've plugged the vehicle in, and reports completion the same way, both via the Grid portal. There's nothing further your app needs to call for either step.
Error responses
{ "error": { "code": "token_expired", "message": "Driver token expired." } }
{ "error": { "code": "token_scope_mismatch", "message": "This token cannot act on a different driver's wallet." } }
{ "error": { "code": "session_not_owned", "message": "This session belongs to a different driver." } }
{ "error": { "code": "session_not_found", "message": "No charge session sess_9f3ac2e1." } }
{ "error": { "code": "session_not_quoted", "message": "Session is pending_quote, not quoted." } }
Also returned once a quoted session has expired (status becomes expired) — see the 5-minute window above.
{ "error": { "code": "invalid_argument", "message": "amount cannot exceed the quoted amount." } }
{ "error": { "code": "insufficient_balance", "message": "Sub-wallet balance 3000 is less than 7500." } }
{ "error": { "code": "connector_busy", "message": "This connector is busy right now — try the other one or again shortly." } }