Skip to content

Event notifications

When a license activates, renews or is revoked, Licentivo can notify your server to synchronize orders, customers and support systems.

To manage license expiration and renewal notifications, subscribe to expiring, expired and renewed events. Your website can verify the latest state and send customer emails. Webhooks report state changes; they do not automatically send reminders on a merchant's behalf.

Add notification endpoint

Open Licensing event notifications, add your server's HTTPS URL and select events. Saving shows the signing secret once; store it on the receiving server. Production does not allow local or private network destinations.

Verify the signature after receipt

Read X-Licentivo-Timestamp, X-Licentivo-Event and the raw request body. Join timestamp + '.' + event ID + '.' + body, calculate HMAC-SHA256 with the signing secret, prepend sha256= and compare with X-Licentivo-Signature in constant time. Reject timestamps more than 5 minutes from now.

Deduplicate by event ID. Verify the signature, place the event in your transaction or queue, and return 2xx after durable storage. For duplicates, return 2xx without repeating order actions.

What happens on failure?

Delivery is tried up to 8 times automatically with increasing delays. The console shows HTTP status, attempt time and errors, and permits manual redelivery. Events and license operations share a database transaction; delivery resumes after a restart.

Events cover creation, updates, renewal, revocation, activation, release, feature consumption, upcoming expiration, expiration and maintenance changes. Notifications include only the license prefix, never its full key.