When and how to use pause and resume command

Integrating with Zaptec chargers through the Cloud API often means automating the pausing and resuming of charging sessions using the Send command endpoint. This is especially relevant when working with the FinalStopActive and ChargerOperationMode values. This guide explains the correct logic and flow for reliably pausing and resuming charging, and how to avoid common API errors.

You will learn:

• When and how to send Pause and Resume commands
• What charger states to check before sending commands
• Permissions and firmware requirements
• Common API rejection cases and troubleshooting tips

📘

Permissions

To execute control commands (Pause, Resume, Restart, Firmware upgrade, Deauthorize), your API caller must have owner or service-level access to the charger.

Supported Command IDs

Command Details

Command 10001 Deauthorize and Stop

Purpose: Immediately stops charging and deauthorizes the current session.

What it does:

• Closes all active sessions
• Reset current sessionId and userId (observations : SessionIdentifier = 721, ChargerCurrentUserUuid = 722)
• Send StopCharging command to the charger

Important: Ensure that no new sessions are authorized until this command completes. This prevents unintended re-authorization during the operation.

Command 506: Pause/Stop Charging

Firmware Requirement:

Requires firmware version > 3.2 on Zaptec Pro chargers. The rest of the chargers supports this

Typical Usage: Used when the charger is actively charging (ChargerOperationMode = 3).

Command Rejection Cases:

• Charger already paused (ChargerOperationMode = 5 and FinalStopActive = 1)
• Charger disconnected (ChargerOperationMode = 1)

✅

Best Practice

• Check ChargerOperationMode = 3 before sending Pause

Example Request

POST /api/chargers/{chargerId}/sendCommand/506
Authorization: Bearer {access_token}
Content-Type: application/json

Response

{
  "Code": 200,
  "Details": "Charging paused successfully"
}

Command 507: Resume Charging

🚧

Firmware Requirement

Requires firmware version > 3.2 on Zaptec Pro chargers.

Typical Usage: Used when the charger is paused (ChargerOperationMode = 5 and FinalStopActive = 1).

Command Rejection Cases:

• Charger not paused (ChargerOperationMode != 5 or FinalStopActive != 1)
• A schedule is active (NextScheduleEvent is set)

✅

Best Practice

• Check FinalStopActive = 1
• Check ChargerOperationMode = 5
• Ensure no schedule is active (NextScheduleEvent not set)

Example Request

POST /api/chargers/{chargerId}/sendCommand/507
Authorization: Bearer {access_token}
Content-Type: application/json

Success Response

{
  "Code": 200,
  "Details": "Charging resumed successfully"
}

Error Response

{
  "Code": 528,
  "Details": "Charging is not Paused nor Scheduled; Resume command cannot be sent"
}

Understanding Key States

Quick Reference Table

State Transition Flow

%% State Transition Flow
stateDiagram-v2
    [*] --> Charging
    Charging --> Paused: Pause (506)
    Paused --> Charging: Resume (507)

    state Charging {
        [*] --> ChargingActive
        ChargingActive: 710 = 3
    }
    state Paused {
        [*] --> PausedActive
        PausedActive: 710 = 5, 718 = 1
    }

Example State Changes

Before Pause

{
  "ChargerOperationMode": 3,
  "FinalStopActive": 0,

}

After Pause

{
  "ChargerOperationMode": 5,
  "FinalStopActive": 1,
}

After Resume

{
  "ChargerOperationMode": 3,
  "FinalStopActive": 0,
}

🚧

Common Pitfalls and Troubleshooting

Issue	Likely Cause	Fix
Resume command rejected (528)	Charger not paused or schedule active	Verify FinalStopActive = 1 and NextScheduleEvent not set
Pause command rejected	Charger not >charging (ChargerOperationMode != 3)	Only send Pause when charging
Charger stays at FinalStopActive = 0 and ChargerOperationMode = 5	EV fully charged	No action needed

HTTP Response Codes

Summary

To Pause Charging

• Check ChargerOperationMode = 3
• Do not check FinalStopActive

To Resume Charging

• Check FinalStopActive = 1
• Check ChargerOperationMode = 5
• Ensure NextScheduleEvent is not set

Requirements

• Owner or service-level access
• Firmware version > 3.2 (Zaptec Pro)

Additional Resources

• Zaptec Cloud API Reference
• Zaptec State Reference
• Zaptec Support