Skip to content

Activation & sessions

Activation turns an entitlement into a running license. A device presents an activation code and a device fingerprint; MonetizeIt issues a session — a signed license bound to that entitlement and device.

A session is the running license. It holds a snapshot of the entitled features and the applied plan (taken at activation, just as the entitlement snapshots at grant), the licensed products, and its time bounds: lease, trial and grace. Devices check in to renew the lease and check out to release a floating seat. The license itself is a signed JWT your application can verify offline with the product’s public key.

  • Online — the device activates and checks in over the network.
  • Hybrid — it activates when connected, then runs on its lease and grace window in between.
  • Air-gapped — for devices with no connectivity, the device produces a signed request, you sign a response (in the portal or via the API), and the device imports it; it then verifies the license by itself, with no network. Usage gathered offline is brought back the same way.
  • Activated from → an entitlement (its features and plan are snapshotted into the session).
  • Reports tometering: usage is recorded against the session and checked against the plan’s tiers.