Subscription Notifications

You can receive notifications whenever your subscription status changes.

Event list

• Subscription Created
• Subscription Suspended
• Subscription Reactivated
• Subscription Canceled
• Subscription Discount Plan Updated
• Subscription Expiration Date Updated - triggered only when the date is shifted outside of the normal renewal process
• Subscription Unpaid - triggered with the email reminder about the unpaid subscription, which depends on the subscription model
• Subscription expired - sent when the grace period ends
• Payment Method Changed

List of fields

Name	Description	R/O
subject	subscription	R
type	Depending on the event: • expiredsubscription • expirationdateupdated • reactivated • suspended • canceled etc	R
objectId	subscriptonId: afe09ab2-25d0-4fdb-857e-dc22ff21ce8f	R
eventDate	2025-07-25T11:30:03Z
subscription {object}	Subscription details object	R
subscription.id	Subscription UUID	R
subscription.createDate	Creation date in ISO 8601 format ex. 2025-07-25T11:30:03Z	R
subscription.modelId	Subscription model, ex: NEXWAY_1Y	R
subscription.name	Subscription name, usually taken from the product Kaspersky Endpoint Security Cloud	O
subscription.storeId	36f48867-d6ca-42d3-bf55-5f54a6740803	R
subscription.lifecycle {object}	Lifecycle details object	R
subscription.lifecycle.id	9191920 Deprecated	O
subscription.lifecycle.generation	Number of term int	R
subscription.products [{object}]	Subscription currently may have only one product	R
subscription.products[].id	Product UUID	R
subscription.products[].lineItemId	Order lineItem UUID	R
subscirption.lifecycle.anniversaryDate	Anniversary date (or the date until the subscription is paid)	R
subscirption.lifecycle.status	Active, Suspended, Dunning, Canceled, Expired	R
subscirption.discountPlan {object}	Discount plan associated with the subscription	O
subscirption.discountPlan.tag		R
subscirption.discountPlan.startingStep		R
subscription.endUserId	Enduser UUID	R

Example

{
   "subject": "subscription",
   "type": "created",
   "objectId": "c0a47254-fb78-4859-8954-d98ff5fb7730",
   "eventDate": "2020-09-07T13:46:57Z",
   "subscription": {
      "id": "c0a47254-fb78-4859-8954-d98ff5fb7730",
      "createDate":"1595918226381",
      "modelId": "NEXWAY_1M",
      "name": "Nexway Secure Connection",
      "lifecycle": {
         "id": "6862801",
         "anniversaryDate" : "2026-04-09T15:30:38Z"
      },
      "products":[
         {
            "id": "d4b35678-94ec-4e8c-acd5-d758a71ede7f",
            "lineItemId": "c5ad58a0-6f41-47cf-9ecc-ab57b034c25e"
         }
      ]
   }
}

Subscription discount plan is changed

This is special notification which will be send in case if subscription plan is changed for subscription. The payload is following:

Name	Description	R/O
subscription.id	Subscription unique identifier	R
subject	subscription	R
type	discount plan updated	R
objectId	UUID of an object (subscription ID in this case)	R
eventDate	2025-09-29T07:34:06Z	R
subscription.discountPlan {object}	Node with subscription plan is added / changed for a given subscription	R
subscription.discountPlan.tag	Subscription discount plan tag is added / chagned	R
subscription.discountPlan.nextDiscountStep	The number of next discount plan step will be used for subscription discounting. Calculates by formula nextDiscountStep=startingStep + generation + 1	R

Example

{
  "subject" : "subscription",
  "type" : "discount plan updated",
  "objectId" : "d888ff3b-0381-4b35-9cbe-f9c73666524f",
  "eventDate" : "2025-01-28T08:58:42Z",
  "subscription" : {
    "id" : "d888ff3b-0381-4b35-9cbe-f9c73666524f",
    "discountPlan": {
      "tag": "tag"
      "nextDiscountStep": 1
    }
  }
}

Subscription Payment Method Changed

This notification is sent when the end-user changes subscription payment method.

Name	Description	R / O
subject	endUser	R
type	subscriptionPaymentMethodUpdated	R
objectId	UUID of an object (enduser ID in this case)	R
eventDate	2025-09-29T07:34:06Z	R
enduser {object}		R
enduser.id	payment method UUID: 8d2eaaf6-9eba-4400-9927-516672d4693b	R
enduser.subscriptionId	subscription id	R
enduser.paymentMethod	payment method type, f.e. creditCard	O
enduser.expirationDate	11/2028	O