Lifecycle

Subscription Lifecycle
Subscription Lifecycle
When you create a subscription, it will be in theINITIALIZED state. Once your customer authorises the subscription, it goes to an intermediary state called BANK_APPROVAL_PENDING. It then goes to the ACTIVEstate after Cashfree receives a secondary confirmation from our partner bank. This takes about two working days.
If the payment method selected is debit/credit card, the subscription directly goes to the ACTIVE state from the INITIALIZED state. You can start charging customers after the subscription is active.
Transaction Lifecycle
Transaction Lifecycle
Once a payment is initiated it will go to the SUCCESS or FAILURE state. The turnaround time for the transaction is dependent on the payment method. We currently support payments via Bank Accounts (e-Mandates) and Cards.
Bank Accounts (e-Mandates): Once the payment is initialized, it takes one day for the payment to go to the SUCCESS or FAILURE state. The status will be in thePENDING state till the bank processes the payment.
Cards: Payments through debit or credit card go to the SUCCESS or FAILURE state immediately.
General Pointers
A subscription ends when one of the following conditions are satisfied.
The maximum cycle reaches the given limit.
The subscription reaches the expiry date set during creation.
The subscription is cancelled from the dashboard or the API on your (merchant) request.
Once the subscription ends,
New transactions cannot be initiated for the subscription.
For the transactions already initiated, it will go to the end-state (Success/Failed). The completion of a transaction is independent of the subscription status.
Transaction Failure 
In the event of a transaction failure, the subscription goes to the ONHOLD state. You can retry the failed transaction using the retry API. If the retry is successful, the subscription will be activated else, it continues to be in the ONHOLD state. 
One retry attempt is allowed per day and only 3 retry attempts are allowed for the failed transactions. If you want to activate the subscription without retrying the payment, you can use the activate API.
Notifications
When a subscription is created or payment gets processed, a notification via an email or text message will be sent to your customers. This is in-compliance with NPCI’s regulations.‌
Cashfree sends notifications to your customers at different stages of the subscription lifecycle described below:
Event
Email Notification
Text notification
Subscription request initiated via Bank account (eMandate)
This notification is sent when your customers initiate a checkout process through Cashfree's checkout page.
False
True
Subscription rejected for payment through Bank account (eMandate)
This notification is sent when your customers or their bank rejects the subscription.
False
True
Subscription created for payment through Bank account (eMandate)
This notification is sent when a subscription is created successfully and approved for payments through your customer's bank account.
True
True
Upcoming payment (For periodic subscriptions - 48 hours prior to debit)
This notification is sent to your customers 48 hours prior to the subscription payment deduction. This will help customers ensure they have sufficient funds in their account.
False
True
Payment confirmation - Success
This notification is sent to your customers when the payment for a subscription is successful.
True
True
Payment confirmation - Failure
This notification is sent to your customers when the payment for a subscription has failed.
True
True
Subscription Cancelled
This notification is sent to your customers when a subscription has been cancelled.
True
True

Subscriptions

Webhooks

Last updated 1 week ago

Event	Email Notification	Text notification
Subscription request initiated via Bank account (eMandate) This notification is sent when your customers initiate a checkout process through Cashfree's checkout page.	False	True
Subscription rejected for payment through Bank account (eMandate) This notification is sent when your customers or their bank rejects the subscription.	False	True
Subscription created for payment through Bank account (eMandate) This notification is sent when a subscription is created successfully and approved for payments through your customer's bank account.	True	True
Upcoming payment (For periodic subscriptions - 48 hours prior to debit) This notification is sent to your customers 48 hours prior to the subscription payment deduction. This will help customers ensure they have sufficient funds in their account.	False	True
Payment confirmation - Success This notification is sent to your customers when the payment for a subscription is successful.	True	True
Payment confirmation - Failure This notification is sent to your customers when the payment for a subscription has failed.	True	True
Subscription Cancelled This notification is sent to your customers when a subscription has been cancelled.	True	True