Create a Subscription

Learn how to create and accept customer payment on a subscription.

A subscription entity represents the customer’s commitment to make regular payments, indicating they are actively using the service and are billed on a recurring basis. The first step in registering a subscription is to obtain authorisation from the customer. When you create a subscription, an authorisation link is provided in the response. You should redirect the customer to this link so they can complete the authorisation process. Once authorised, the subscription transitions to an active state.

Dashboard

To create a new subscription from the dashboard, Go to Subscriptions Dashboard > All Subscriptions > Create Subscription. Follow the steps as shown in the below image.

You can also create multiple subscriptions at once using the dashboard. Go to Subscriptions Dashboard > Batch Subscriptions > Upload File to upload a file that contains all the information required for multiple subscriptions.

API

To create a new subscription via API, refer Create Mandate.

Currently, creation of multiple subscriptions at once using API is not supported.

Authorisation Lifecycle

Before a subscription becomes ACTIVE, it must be authorised by the customer. Authorisation indicates that the customer has completed the initial payment (if applicable) and successfully subscribed. If the customer doesn’t complete payment within a certain timeframe, the subscription link will expire. Below is a visual diagram illustrating the different states during the authorisation process.

Subscription Lifecycle

A subscription can go through various states once it is created. They are explained in the table below:

Subscription State	Description
initialised	Subscription is created but awaiting customer authorisation.
BANK APPROVAL PENDING	Customer has authorized, but bank confirmation is pending before activation. This is applicable for NACH.
ACTIVE	Subscription is fully authorized by the bank and ready for payment collection.
ON HOLD	Subscription is on hold due to a failed recurring payment and will resume once reactivated. This is applicable for periodic mandates on NACH and Cards standing instructions payment methods.
PAUSED	Subscription is paused by the merchant, only available for active periodic subscriptions.
COMPLETED	Subscription has reached its cycle or expiry limit and is now completed.
CUSTOMER CANCELLED	Customer canceled the subscription at the bank. Canceled subscriptions cannot be resumed.
CUSTOMER_PAUSED	Customer paused the subscription from their UPI app; only the customer can resume it.
EXPIRED	Subscription has reached its expiry date and can no longer process payments.
LINK EXPIRED	Authorisation link expired without successful completion by the customer; no further action possible. This applies to non-seamless subscriptions created after May 4, 2023.