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:
UPI
ENACH
PNACH
Debit/Credit card
"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
CANCELLED
CARD_EXPIRED
Version (2025-01-01)
Version (2023-08-01)
{ "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.
Version (2025-01-01)
Version (2023-08-01)
{ "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)
Version (2023-08-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)
Version (2023-08-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.
Version (2025-01-01)
Version (2023-08-01)
{ "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)
Version (2023-08-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.
Version (2025-01-01)
Version (2023-08-01)
{ "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" } SUBSCRIPTION_CARD_EXPIRY_REMINDER This event is triggered 7 days prior to the card’s expiry date for active card subscriptions.
{ "data" : { "subscription_status_webhook" : { "subscription_details" : { "cf_subscription_id" : "23661347" , "subscription_id" : "SUB_TEST_1754550382119" , "subscription_status" : "ACTIVE" , "subscription_expiry_time" : "2050-12-31T00:00:00" , "subscription_first_charge_time" : "2025-09-30T00:00:00" , "subscription_tags" : { "next_schedule_date" : "2025-09-30T00:10:00" } }, "customer_details" : { "customer_name" : "John Doe" , "customer_email" : "john@cashfree.com" , "customer_phone" : "9090909090" }, "plan_details" : { "plan_id" : "PLAN_1754550139964" , "plan_name" : "MY_PLAN" , "plan_type" : "PERIODIC" , "plan_max_cycles" : 2 , "plan_recurring_amount" : 5 , "plan_max_amount" : 1000 , "plan_interval_type" : "MONTH" , "plan_intervals" : 1 , "plan_currency" : null , "plan_note" : null , "plan_status" : null }, "authorization_details" : { "authorizationAmount" : 1 , "authorizationAmountRefund" : false , "approveByTime" : "2025-09-06T12:36:22" , "authorizationReference" : null , "authorizationTime" : "2025-08-07T13:14:18" , "authorizationStatus" : "ACTIVE" , "paymentId" : "160594_178_1754552533131" , "paymentMethod" : "card" , "instrumentId" : null }, "payment_gateway_details" : { "gateway_name" : "CASHFREE" , "gateway_subscription_id" : "23661347" , "gateway_plan_id" : "PLAN_1754550139964" , "gateway_auth_id" : null } }, "card_expiry_date" : "2025-09-30" }, "event_time" : "2025-09-24T02:00:09+05:30" , "type" : "SUBSCRIPTION_CARD_EXPIRY_REMINDER" } 
