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

FieldTypeRequiredDescription
sessionIdstringYesReturned by Quote Charge Session when a manual charger's response has awaitingOperatorQuote: true.
driverEmailstringYesMust match the email your driver token was minted for.
amountnumberYesNGN 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

401 token_expired
{ "error": { "code": "token_expired", "message": "Driver token expired." } }
403 token_scope_mismatch
{ "error": { "code": "token_scope_mismatch", "message": "This token cannot act on a different driver's wallet." } }
403 session_not_owned
{ "error": { "code": "session_not_owned", "message": "This session belongs to a different driver." } }
404 session_not_found
{ "error": { "code": "session_not_found", "message": "No charge session sess_9f3ac2e1." } }
409 session_not_quoted
{ "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.

400 invalid_argument
{ "error": { "code": "invalid_argument", "message": "amount cannot exceed the quoted amount." } }
402 insufficient_balance
{ "error": { "code": "insufficient_balance", "message": "Sub-wallet balance 3000 is less than 7500." } }
409 connector_busy
{ "error": { "code": "connector_busy", "message": "This connector is busy right now — try the other one or again shortly." } }