Recurring Payments

Subscription Status and Workflow

A subscription can go through various states once it is created. They are explained in the table below:
Subscription States
Description
INITIALIZED
A subscription is in the INITIALIZED state when it is created. This status shows the subscription is created but the customer has not authorized it yet.
BANK APPROVAL PENDING
This state indicates that your customer has authorized the mandate. However, we are yet to receive the final confirmation from the bank before we can activate the subscription.
ACTIVE
The subscription is ACTIVE when the bank has authorised the subscription and you can start collecting payments for this subscription.
ON HOLD
A subscription moves to the ON HOLD state when the recurring payment fails for a periodic subscription. When it is re-activated, the subscription is updated from the ON HOLD state to the ACTIVE state.
PAUSED
A subscription moves to the PAUSED state when you pause your periodic subscriptions. Only a periodic subscription that is in the ACTIVE state can be paused.
COMPLETED
A subscription is COMPLETED when the maximum number of cycles is reached or the subscription expiry is reached.
CUSTOMER CANCELLED
This state indicates that your customer has cancelled their subscription at the bank’s end. If a subscription is cancelled by your customer it cannot be resumed.
CUSTOMER_PAUSED
This state indicates that your customer has paused their subscription from their UPI application. If a subscription is paused by your customer only they can resume it.
EXPIRED
An EXPIRED status indicates that the subscription has passed its expiry date and cannot be resumed. A subscription that is EXPIRED cannot accept any fresh payment requests.
LINK EXPIRED
This status indicates that the subscription link has expired and there has been no successful authorisation done by the customer for this Subscription. This is one of the terminal states and no further action can be performed on these subscriptions.
﻿
﻿
﻿

Cancel Charge

Transaction Lifecycle

Subscription States	Description
INITIALIZED	A subscription is in the INITIALIZED state when it is created. This status shows the subscription is created but the customer has not authorized it yet.
BANK APPROVAL PENDING	This state indicates that your customer has authorized the mandate. However, we are yet to receive the final confirmation from the bank before we can activate the subscription.
ACTIVE	The subscription is ACTIVE when the bank has authorised the subscription and you can start collecting payments for this subscription.
ON HOLD	A subscription moves to the ON HOLD state when the recurring payment fails for a periodic subscription. When it is re-activated, the subscription is updated from the ON HOLD state to the ACTIVE state.
PAUSED	A subscription moves to the PAUSED state when you pause your periodic subscriptions. Only a periodic subscription that is in the ACTIVE state can be paused.
COMPLETED	A subscription is COMPLETED when the maximum number of cycles is reached or the subscription expiry is reached.
CUSTOMER CANCELLED	This state indicates that your customer has cancelled their subscription at the bank’s end. If a subscription is cancelled by your customer it cannot be resumed.
CUSTOMER_PAUSED	This state indicates that your customer has paused their subscription from their UPI application. If a subscription is paused by your customer only they can resume it.
EXPIRED	An EXPIRED status indicates that the subscription has passed its expiry date and cannot be resumed. A subscription that is EXPIRED cannot accept any fresh payment requests.
LINK EXPIRED	This status indicates that the subscription link has expired and there has been no successful authorisation done by the customer for this Subscription. This is one of the terminal states and no further action can be performed on these subscriptions.