Below are the various events that can be sent to your webhook endpoint. These webhooks will be triggered if the merchant has integrated our newer Subscription API.
Note: If the merchant added the webhook under the 2025-01-01 version, they will receive the same version of the webhook for older subscriptions as well.
Payment method object attributes: 
"payment_method": {
      "upi": {
        "channel": "collect",
        "upi_id": "8709228804@ybl",
        "upi_instrument": "",
        "upi_instrument_number": "",
        "upi_payer_account_number": "",
        "upi_payer_ifsc": ""
      }
},
"payment_group": "upi"

​
SUBSCRIPTION_STATUS_CHANGED

Whenever a subscription is created it goes to initialised state and customer is expected to authorise it. The list of statuses where this webhook will get triggered are:
  • ACTIVE
  • ON_HOLD
  • COMPLETED
  • CUSTOMER_CANCELLED
  • CUSTOMER_PAUSED
  • EXPIRED
  • LINK_EXPIRED
  • BANK_APPROVAL_PENDING
{
"data": {
"subscription_details": {
  "cf_subscription_id": "23639356",
  "subscription_id": "mozuyYwUCbWEfJVVRLi",
  "subscription_status": "BANK_APPROVAL_PENDING",
  "subscription_expiry_time": "2055-08-07T10:30:46",
  "subscription_first_charge_time": null,
  "subscription_tags": null,
  "next_schedule_date": null
},
"customer_details": {
  "customer_name": null,
  "customer_email": "john@dummy.com",
  "customer_phone": "9900000000"
},
"plan_details": {
  "plan_id": "mozuyYwUCbWEfJVVRLi",
  "plan_name": "6Msuj2mttuf2F5P1FYVSet",
  "plan_type": "ON_DEMAND",
  "plan_max_cycles": 0,
  "plan_recurring_amount": null,
  "plan_max_amount": 399.00,
  "plan_interval_type": null,
  "plan_intervals": null,
  "plan_currency": "INR",
  "plan_note": null,
  "plan_status": null
},
"authorization_details": {
  "authorization_amount": 2.00,
  "authorization_amount_refund": false,
  "approve_by_time": "2025-09-06T10:30:47",
  "authorization_reference": "6ba74ac2b047424da95591xxxxx[at]xxxx",
  "authorization_time": "2025-08-07T10:31:36",
  "authorization_status": "PENDING",
  "payment_id": "49988270",
  "payment_method": {
    "upi": {
      "channel": "link",
      "upi_id": "9910000000@ybl",
      "upi_instrument": "",
      "upi_instrument_number": "",
      "upi_payer_account_number": "",
      "upi_payer_ifsc": ""
    }
  },
  "payment_group": "upi"
},
"payment_gateway_details": {
  "gateway_name": "CASHFREE",
  "gateway_subscription_id": "23639356",
  "gateway_plan_id": "mozuyYwUCbWEfJVVRLi",
  "gateway_auth_id": "6ba74ac2b047424da95591xxxxx[at]xxxx"
}
},
"event_time": "2025-08-07T10:31:35+05:30",
"type": "SUBSCRIPTION_STATUS_CHANGED"
}

​
SUBSCRIPTION_AUTH_STATUS

The event is triggered when the checkout is completed by the customer for success and failed cases. 
{
 "data": {
   "payment_id": "ab-SUBV2ODRFhdJuHlcQYyFw-1",
   "cf_payment_id": "49988825",
   "cf_txn_id": "4213159266",
   "cf_order_id": "4519691525",
   "subscription_id": "mozth7smWGCCqPRaSv7",
   "cf_subscription_id": "23639858",
   "payment_type": "AUTH",
   "authorization_details": {
     "authorization_amount": 2.00,
     "authorization_amount_refund": false,
     "approve_by_time": "",
     "authorization_reference": "cce92d335be0467693c020xxxxx[at]xxxx",
     "authorization_time": "2025-08-07T10:34:23+05:30",
     "authorization_status": "FAILED",
     "payment_id": "ab-SUBV2ODRFhdJuHlcQYyFw-1",
     "payment_method": {
       "upi": {
         "channel": "link",
         "upi_id": "9910000000@ybl",
         "upi_instrument": "",
         "upi_instrument_number": "",
         "upi_payer_account_number": "",
         "upi_payer_ifsc": ""
       }
     },
     "payment_group": "upi"
   },
   "payment_amount": 2.00,
   "payment_currency": "INR",
   "payment_schedule_date": "",
   "payment_initiated_date": "2025-08-07T10:33:56+05:30",
   "payment_remarks": "auth payment",
   "retry_attempts": 0,
   "failure_details": {
     "failure_reason": "DEBIT HAS BEEN FAILED"
   },
   "payment_status": "FAILED",
   "payment_gateway_details": {
     "gateway_name": "CASHFREE",
     "gateway_subscription_id": "23639858",
     "gateway_payment_id": "49988825"
   }
 },
 "event_time": "2025-08-07T10:34:23+05:30",
 "type": "SUBSCRIPTION_AUTH_STATUS"
}

​
SUBSCRIPTION_PAYMENT_NOTIFICATION_INITIATED

This webhook is used to inform the merchant that we have sent a notification of payment to the customer.
Version (2025-01-01)
{
"data": {
"payment_id": "ab-SUBV2ODR683gV1CXF85ev-1",
"cf_payment_id": "49970855",
"cf_txn_id": null,
"cf_order_id": "",
"subscription_id": "moziva9hyjiLtCuGN74",
"cf_subscription_id": "22390006",
"payment_type": "CHARGE",
"authorization_details": {
  "authorization_amount": 399.00,
  "authorization_amount_refund": false,
  "approve_by_time": "",
  "authorization_reference": null,
  "authorization_time": "",
  "authorization_status": null,
  "payment_id": "ab-SUBV2ODR683gV1CXF85ev-1",
  "payment_method": null,
  "payment_group": null
},
"payment_amount": 399.00,
"payment_currency": "INR",
"payment_schedule_date": "2025-08-08T12:00:00+05:30",
"payment_initiated_date": "2025-08-07T09:08:09+05:30",
"payment_remarks": null,
"retry_attempts": 0,
"failure_details": {
  "failure_reason": null
},
"payment_status": "INITIALIZED",
"payment_gateway_details": {
  "gateway_name": "CASHFREE",
  "gateway_subscription_id": "22390006",
  "gateway_payment_id": "49970855"
}
},
"event_time": "2025-08-07T09:51:07+05:30",
"type": "SUBSCRIPTION_PAYMENT_NOTIFICATION_INITIATED"
}

​
SUBSCRIPTION_PAYMENT_SUCCESS

This notification is sent whenever a successful payment is processed for an active subscription.
Version (2025-01-01)
{
"data": {
"payment_id": "ab-SUBV2ODRc5Dl2meCr7Iui-1",
"cf_payment_id": "49914526",
"cf_txn_id": "4212435861",
"cf_order_id": "4518936510",
"subscription_id": "moznV33AssPd6vXsSm2",
"cf_subscription_id": "23601811",
"payment_type": "AUTH",
"authorization_details": {
  "authorization_amount": 2.00,
  "authorization_amount_refund": false,
  "approve_by_time": "",
  "authorization_reference": "427b608f83ad4cbdb6d472xxxxx[at]xxxx",
  "authorization_time": "2025-08-07T05:53:22+05:30",
  "authorization_status": "ACTIVE",
  "payment_id": "ab-SUBV2ODRc5Dl2meCr7Iui-1",
  "payment_method": {
    "upi": {
      "channel": "link",
      "upi_id": "8100000000@ybl",
      "upi_instrument": "",
      "upi_instrument_number": "",
      "upi_payer_account_number": "",
      "upi_payer_ifsc": ""
    }
  },
  "payment_group": "upi"
},
"payment_amount": 2.00,
"payment_currency": "INR",
"payment_schedule_date": "",
"payment_initiated_date": "2025-08-07T05:52:21+05:30",
"payment_remarks": "auth payment",
"retry_attempts": 0,
"failure_details": {
  "failure_reason": null
},
"payment_status": "SUCCESS",
"payment_gateway_details": {
  "gateway_name": "CASHFREE",
  "gateway_subscription_id": "23601811",
  "gateway_payment_id": "49914526"
}
},
"event_time": "2025-08-07T05:53:21+05:30",
"type": "SUBSCRIPTION_PAYMENT_SUCCESS"
}

​
SUBSCRIPTION_PAYMENT_FAILED

This notification is sent whenever payment processing fails for an active subscription. 
{
"data": {
"payment_id": "ab-SUBV2ODRIeYlFEhMHfS0M-1",
"cf_payment_id": "49585655",
"cf_txn_id": "4212555720",
"cf_order_id": "4519061918",
"subscription_id": "mozh4iRHSsjre7GkDNz",
"cf_subscription_id": "22393526",
"payment_type": "CHARGE",
"authorization_details": {
  "authorization_amount": 399.00,
  "authorization_amount_refund": false,
  "approve_by_time": "",
  "authorization_reference": "a7d6101a7d9340269f070dxxxxx[at]xxxx",
  "authorization_time": "2025-07-25T22:37:53+05:30",
  "authorization_status": "ACTIVE",
  "payment_id": "ab-SUBV2ODRIeYlFEhMHfS0M-1",
  "payment_method": {
    "upi": {
      "channel": "link",
      "upi_id": "9910000000@ybl",
      "upi_instrument": "",
      "upi_instrument_number": "",
      "upi_payer_account_number": "",
      "upi_payer_ifsc": ""
    }
  },
  "payment_group": "upi"
},
"payment_amount": 399.00,
"payment_currency": "INR",
"payment_schedule_date": "2025-08-07T12:00:00+05:30",
"payment_initiated_date": "2025-08-06T05:02:41+05:30",
"payment_remarks": null,
"retry_attempts": 0,
"failure_details": {
  "failure_reason": "DEBIT FAILED | Insufficient Funds In Customer (Remitter) Account"
},
"payment_status": "FAILED",
"payment_gateway_details": {
  "gateway_name": "CASHFREE",
  "gateway_subscription_id": "22393526",
  "gateway_payment_id": "49585655"
}
},
"event_time": "2025-08-07T10:24:45+05:30",
"type": "SUBSCRIPTION_PAYMENT_FAILED"
}

​
SUBSCRIPTION_PAYMENT_CANCELLED

This notification is sent whenever payment processing is cancelled by user for an active subscription.
Version (2025-01-01)
{
"data": {
"payment_id": "433563_33_1754492527395",
"cf_payment_id": "2011332",
"cf_txn_id": null,
"cf_order_id": "",
"subscription_id": "subTestIdOndemand_2025080615020470",
"cf_subscription_id": "1220385",
"payment_type": "CHARGE",
"authorization_details": {
  "authorization_amount": 1.00,
  "authorization_amount_refund": false,
  "approve_by_time": "",
  "authorization_reference": null,
  "authorization_time": "",
  "authorization_status": null,
  "payment_id": "433563_33_1754492527395",
  "payment_method": null,
  "payment_group": null
},
"payment_amount": 1.00,
"payment_currency": "INR",
"payment_schedule_date": "2025-08-08T12:00:00+05:30",
"payment_initiated_date": "2025-08-06T20:32:07+05:30",
"payment_remarks": null,
"retry_attempts": 0,
"failure_details": {
  "failure_reason": null
},
"payment_status": "CANCELLED",
"payment_gateway_details": {
  "gateway_name": "CASHFREE",
  "gateway_subscription_id": "1220385",
  "gateway_payment_id": "2011332"
}
},
"event_time": "2025-08-06T20:32:07+05:30",
"type": "SUBSCRIPTION_PAYMENT_CANCELLED"
}

​
SUBSCRIPTION_REFUND_STATUS

This event is triggered whenever a refund status of a transaction will be success, failed, or cancelled. 
{
"data": {
"payment_id": "yCzJxeT2aXDqI",
"cf_payment_id": "49778199",
"refund_id": "WHOqiwy05P1l0",
"cf_refund_id": "SUB_21ebb4bf-e84f-4afa-bb09-07aac433abe4",
"refund_amount": 1000.00,
"refund_speed": "STANDARD",
"refund_note": "Tesg Refund",
"refund_status": "SUCCESS",
"failure_details": "",
"refund_gateway_details": {
  "gateway_name": "CASHFREE",
  "gateway_payment_id": "49778199",
  "gateway_refund_id": "SUB_21ebb4bf-e84f-4afa-bb09-07aac433abe4"
}
},
"event_time": "2025-08-06T17:20:02+05:30",
"type": "SUBSCRIPTION_REFUND_STATUS"
}