Subscription Notifications

You can receive notifications whenever your subscription status changes.

History of changes

Change tag	Change description	Change date
FRQ-410	The new type of notification "Subscription Payment Method Replayability Changed" is added	12.12.2025
IAP-27695	paymentMethodName is added into Subscription Payment Method Changed notification	15.12.2025

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: • reactivated • suspended • canceled see notifications with subject=`subscription`	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 Updated

This notification will be sent when the subscription discount plan is updated.

Payload

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 / updated 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
enduser.paymentMethodName	IAP-27695 - The payment method name, f.e. visa	O

FRQ-410

Subscription Payment Method Replayability Changed

This notification is sent when:

1. New subscription is created

Condition to check:

payment method is NOT attached to the subscription in the endUser’s wallet
How to reflect it in the notification:
- paymentMethodNonReplayable=true
- warningReason=paymentMethodIsNotAttachedToSubscription
payment method will expire sooner than the planned billing date
How to reflect it in the notification:
- paymentMethodNonReplayable=true
- warningReason=paymentMethodExpiresSoon