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": "857805",
  "subscription_id": "check1",
  "subscription_status": "CANCELLED",
  "subscription_expiry_time": "2055-04-04T17:45:19",
  "subscription_first_charge_time": "2025-04-16T00:00:00",
  "subscription_tags": null
},
"customer_details": {
  "customer_name": "Webhook check1",
  "customer_email": "shubham.bansal@gmail.com",
  "customer_phone": "9900876578"
},
"plan_details": {
  "plan_id": null,
  "plan_name": "Check1",
  "plan_type": "PERIODIC",
  "plan_max_cycles": 7,
  "plan_recurring_amount": 10,
  "plan_max_amount": 10,
  "plan_interval_type": "MONTH",
  "plan_intervals": 1,
  "plan_currency": null,
  "plan_note": null,
  "plan_status": null
},
"authorization_details": {
  "authorizationAmount": 1,
  "authorizationAmountRefund": false,
  "approveByTime": "2025-05-04T17:45:19",
  "authorizationReference": "POSNnwr0NZWo1paEGnAmcxPgCeybmC@upi",
  "authorizationTime": "2025-04-04T17:46:39",
  "authorizationStatus": "ACTIVE",
  "paymentId": "955957",
  "payment_method": {
    "upi": {
      "channel": "collect",
      "upi_id": "8709228804@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": "857805",
  "gateway_plan_id": null,
  "gateway_auth_id": "POSNnwr0NZWo1paEGnAmcxPgCeybmC@upi"
}
},
"event_time": "2025-04-07T14:53:46+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": "10533294_242_1744017942228",
   "cf_payment_id": "969185",
   "cf_txn_id": "5114917189861",
   "cf_order_id": 2191912575,
   "subscription_id": "check6",
   "cf_subscription_id": "862991",
   "payment_type": "AUTH",
   "authorization_details": {
     "authorization_amount": 1,
     "authorization_amount_refund": false,
     "approve_by_time": "",
     "authorization_reference": null,
     "authorization_time": "2025-04-07T14:55:42+05:30",
     "authorization_status": "INITIALIZED",
     "payment_id": "10533294_242_1744017942228",
     "payment_method": {
       "upi": {
         "channel": "collect",
         "upi_id": "8709228804@ybl",
         "upi_instrument": "",
         "upi_instrument_number": "",
         "upi_payer_account_number": "",
         "upi_payer_ifsc": ""
       }
     },
     "payment_group": "upi"
   },
   "payment_amount": 1,
   "payment_currency": "INR",
   "payment_schedule_date": "",
   "payment_initiated_date": "2025-04-07T14:55:42+05:30",
   "payment_remarks": "auth payment",
   "retry_attempts": 0,
   "failure_details": {
     "failure_reason": null
   },
   "payment_status": "PENDING",
   "payment_gateway_details": {
     "gateway_name": "CASHFREE",
     "gateway_subscription_id": "862991",
     "gateway_payment_id": "969185"
   }
 },
 "event_time": "2025-04-07T14:55:44+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": "10533294_89_1744054393597",
"cf_payment_id": "969934",
"cf_txn_id": null,
"cf_order_id": null,
"subscription_id": "check10",
"cf_subscription_id": "863147",
"payment_type": "CHARGE",
"authorization_details": {
  "authorization_amount": 10,
  "authorization_amount_refund": false,
  "approve_by_time": "",
  "authorization_reference": {
    "authorization_time": "",
    "authorization_status": "ACTIVE",
    "payment_id": "10533294_89_1744054393597",
    "payment_method": {
      "upi": {
        "channel": "collect",
        "upi_id": "8709228804@ybl",
        "upi_instrument": "",
        "upi_instrument_number": "",
        "upi_payer_account_number": "",
        "upi_payer_ifsc": ""
      }
    },
    "payment_group": "upi"
  },
  "payment_amount": 10,
  "payment_currency": "INR",
  "payment_schedule_date": "2025-04-09T12:00:00+05:30",
  "payment_initiated_date": "2025-04-08T01:03:14+05:30",
  "payment_remarks": "",
  "retry_attempts": 0,
  "failure_details": {
    "failure_reason": null
  },
  "payment_status": "INITIALIZED",
  "payment_gateway_details": {
    "gateway_name": "CASHFREE",
    "gateway_subscription_id": "863147",
    "gateway_payment_id": "969934"
  }
},
"event_time": "2025-04-08T17:00:24+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": "10533294_242_1744017942228",
"cf_payment_id": "969185",
"cf_txn_id": "5114917189861",
"cf_order_id": 2191912575,
"subscription_id": "check6",
"cf_subscription_id": "862991",
"payment_type": "AUTH",
"authorization_details": {
  "authorization_amount": 1,
  "authorization_amount_refund": false,
  "approve_by_time": "",
  "authorization_reference": "xDKzVxTxw3viaYISZffrcy9K0ByaT0@upi",
  "authorization_time": "2025-04-07T14:55:44+05:30",
  "authorization_status": "ACTIVE",
  "payment_id": "10533294_242_1744017942228",
  "payment_method": {
    "upi": {
      "channel": "collect",
      "upi_id": "8709228804@ybl",
      "upi_instrument": "",
      "upi_instrument_number": "",
      "upi_payer_account_number": "",
      "upi_payer_ifsc": ""
    }
  },
  "payment_group": "upi"
},
"payment_amount": 1,
"payment_currency": "INR",
"payment_schedule_date": "",
"payment_initiated_date": "2025-04-07T14:55:42+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": "862991",
  "gateway_payment_id": "969185"
}
},
"event_time": "2025-04-07T14:55:44+05:30",
"type": "SUBSCRIPTION_PAYMENT_SUCCESS"
}

​
SUBSCRIPTION_PAYMENT_FAILED

This notification is sent whenever payment processing fails for an active subscription. 
{
"data": {
"payment_id": "10533294_531_1744184404303",
"cf_payment_id": "983717",
"cf_txn_id": 67890,
"cf_order_id": 98765,
"subscription_id": "check19",
"cf_subscription_id": "868529",
"payment_type": "CHARGE",
"authorization_details": {
  "authorization_amount": 1,
  "authorization_amount_refund": false,
  "approve_by_time": "",
  "authorization_reference": "xDKzVxTxw3viaYISZffrcy9K0ByaT0@upi",
  "authorization_time": "2025-04-07T14:55:44+05:30",
  "authorization_status": "ACTIVE",
  "payment_id": "10533294_242_1744017942228",
  "payment_method": {
    "upi": {
      "channel": "collect",
      "upi_id": "8709228804@ybl",
      "upi_instrument": "",
      "upi_instrument_number": "",
      "upi_payer_account_number": "",
      "upi_payer_ifsc": ""
    }
  },
  "payment_group": "upi"
},
"payment_amount": 10,
"payment_currency": "INR",
"payment_schedule_date": "2025-04-11T12:00:00+05:30",
"payment_initiated_date": "2025-04-09T13:10:04+05:30",
"payment_remarks": "",
"retry_attempts": 0,
"failure_details": {
  "failure_reason": "Notification couldn't be sent to the customer"
},
"payment_status": "FAILED",
"payment_gateway_details": {
  "gateway_name": "CASHFREE",
  "gateway_subscription_id": "868529",
  "gateway_payment_id": "983717"
}
},
"event_time": "2025-04-10T21:02:54+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": "10533294_531_1744184404303",
"cf_payment_id": "983717",
"cf_txn_id": 67890,
"cf_order_id": 98765,
"subscription_id": "check19",
"cf_subscription_id": "868529",
"payment_type": "CHARGE",
"authorization_details": {
  "authorization_amount": 1,
  "authorization_amount_refund": false,
  "approve_by_time": "",
  "authorization_reference": "xDKzVxTxw3viaYISZffrcy9K0ByaT0@upi",
  "authorization_time": "2025-04-07T14:55:44+05:30",
  "authorization_status": "ACTIVE",
  "payment_id": "10533294_242_1744017942228",
  "payment_method": {
    "upi": {
      "channel": "collect",
      "upi_id": "8709228804@ybl",
      "upi_instrument": "",
      "upi_instrument_number": "",
      "upi_payer_account_number": "",
      "upi_payer_ifsc": ""
    }
  },
  "payment_group": "upi"
},
"payment_amount": 10,
"payment_currency": "INR",
"payment_schedule_date": "2025-04-11T12:00:00+05:30",
"payment_initiated_date": "2025-04-09T13:10:04+05:30",
"payment_remarks": "",
"retry_attempts": 0,
"failure_details": {
  "failure_reason": "Customer has cancelled the mandate."
},
"payment_status": "CANCELLED",
"payment_gateway_details": {
  "gateway_name": "CASHFREE",
  "gateway_subscription_id": "868529",
  "gateway_payment_id": "983717"
}
},
"event_time": "2025-04-10T21:02:54+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": "pay8643",
    "cf_payment_id": "863782648",
    "refund_id": "refund2",
    "cf_refund_id": "ref_212",
    "refund_amount": 100,
    "refund_note": "test",
    "refund_speed": "INSTANT",
    "refund_status": "SUCCESS",
    "failure_details": null,
    "payment_gateway_details": {
        "gateway_name": "CASHFREE",
        "gateway_payment_id": "pay8643",
        "gateway_refund_id": "refund2"
    }
},
"event_time": "2023-01-03T11:16:10+05:30",
"type": "SUBSCRIPTION_REFUND_STATUS"
}