Webhook Events

ProxGate can send real-time notifications to your server when licensing events occur.

Signature Verification

Each webhook delivery includes an X-ProxGate-Signature header containing an HMAC-SHA256 signature of the payload.

const crypto = require('crypto');

function verifyWebhook(payload, signature, secret) {
  const expected = crypto
    .createHmac('sha256', secret)
    .update(JSON.stringify(payload))
    .digest('hex');
  return crypto.timingSafeEqual(
    Buffer.from(signature),
    Buffer.from(expected)
  );
}

Additional headers: X-ProxGate-Event (event type) and X-ProxGate-Delivery (unique delivery ID).

Available Events

LICENSE_ACTIVATED

When a license is successfully activated on a device

LICENSE_DEACTIVATED

When a license activation is removed from a device

LICENSE_EXPIRED

When a license reaches its expiration date

LICENSE_VALIDATED

When a license validation check is performed

LICENSE_CREATED

When a new license key is generated

LICENSE_REVOKED

When a license is revoked by an administrator

LICENSE_SUSPENDED

When a license is temporarily suspended

LICENSE_TRANSFERRED

When a license is transferred between devices/domains

PRODUCT_CREATED

When a new product is created

PRODUCT_UPDATED

When product details are modified

CUSTOMER_CREATED

When a new customer record is created

ACTIVATION_CREATED

When a new device activation is recorded

ACTIVATION_REMOVED

When a device activation is removed

Retry Policy

Failed deliveries are automatically retried with exponential backoff:

Attempt 2

1 min

Attempt 3

5 min

Attempt 4

15 min

Attempt 5

30 min

Attempt 6

60 min