SUBSCRIPTION STATUS

Event Overview

Event Type: SUBSCRIPTION_STATUS
Category: Subscription
Description: Subscription status has been updated This webhook is triggered when a subscription status changes or subscription information is updated.

Payload Schema

{
    "event_type": "SUBSCRIPTION_STATUS",
    "event_time": "2026-02-15T16:53:15.123456",
    "version": "3.0.0",
    "sequence_number": "a3791670-7c5d-4a86-aa7a-fe35e58a9dbb",
    "data": {
        "subscriptions": [
            {
                "subscription_id": "SUB123456",
                "status": "ACTIVE",
                "billing_amount": 1000.00,
                "billing_currency": "INR",
                "billing_cycle": "MONTHLY",
                "payment_start_date": "2024-01-01",
                "payment_end_date": "2024-12-31"
            }
        ]
    }
}

Field Specifications

Root Level Fields
Data Object Fields

string

required

Always "SUBSCRIPTION_STATUS" for this webhook event

string

required

UTC, no timezone suffix, e.g. "2026-02-15T16:53:15.123456". Parse tolerantly — fractional seconds can be absent.

string

required

API version of your account, e.g. "3.0.0"

string

required

Unique ID of this event (a UUID, not an ordering counter). A retry resends the same value; use it to de-duplicate.Example: "a3791670-7c5d-4a86-aa7a-fe35e58a9dbb"

object

required

Event-specific data payload containing subscription details

array

required

Array of subscription objects containing the subscription information

string

required

Unique subscription identifierExample: "SUB123456"

string

required

Current status of the subscriptionExample: "ACTIVE"

number

required

Billing amount for the subscriptionExample: 1000.00

string

required

Currency code for the billing amountExample: "INR"

string

required

Billing cycle frequencyExample: "MONTHLY"

string

required

Start date for subscription payments in YYYY-MM-DD formatExample: "2024-01-01"

string

required

End date for subscription payments in YYYY-MM-DD formatExample: "2024-12-31"

Order

Payment

Merchant

Settlement

Refund

Subscriptions

Payment Links

Virtual Bank Accounts

LRS

B2B Services

Webhooks

Event Overview

Payload Schema

Field Specifications

​Event Overview

​Payload Schema

​Field Specifications

Event Overview

Payload Schema

Field Specifications