> ## Documentation Index
> Fetch the complete documentation index at: https://cashfreepayments-d00050e9-handbook-faq-creation.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Create a Subscription

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

A subscription entity signifies the customer's commitment to make regular payments, showing they actively use the service and pay on a recurring basis. To register a subscription, first obtain the customer's authorisation. When you create a subscription, the response includes an authorisation link. Redirect the customer to this link to complete the authorisation process. Once the customer authorises, the subscription becomes active.

<Tabs>
  <Tab title="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.

    <img height="200" src="https://mintcdn.com/cashfreepayments-d00050e9-handbook-faq-creation/9-Q-AP3yUNmbCIMP/static/payments/no-code/payment-links/create-subscription.gif?fit=max&auto=format&n=9-Q-AP3yUNmbCIMP&q=85&s=f8a59b4d57cada6ea70027c5fa229ed6" width="1920" height="987" data-path="static/payments/no-code/payment-links/create-subscription.gif" />

    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.
  </Tab>

  <Tab title="API">
    To create a new subscription via API, refer [Create Mandate](/api-reference/payments/latest/subscription/mandate/create).

    > Currently, creation of multiple subscriptions at once using API is not supported.
  </Tab>
</Tabs>

## Authorisation lifecycle

Before a subscription becomes ACTIVE, the customer must authorise it. 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.

```mermaid
stateDiagram-v2
    [*] --> initialised

    Initialised --> BANK_APPROVAL_PENDING: Customer completes authorisation
    Initialised --> CANCELLED: Cancelled by merchant
    Initialised --> LINK_EXPIRED: Checkout link expires

    BANK_APPROVAL_PENDING --> ACTIVE: Bank approval successful
    BANK_APPROVAL_PENDING --> COMPLETED: Subscription expires
    BANK_APPROVAL_PENDING --> CANCELLED: Cancelled by merchant
    BANK_APPROVAL_PENDING --> Initialised: Authorisation unsuccessful



    CANCELLED --> [*]
    COMPLETED --> [*]
    LINK_EXPIRED --> [*]
```

## Authorisation lifecycle

The table below explains the various states an authorisation can go through once it's created:

| Authorisation State | Description                                                                           |
| ------------------- | ------------------------------------------------------------------------------------- |
| **INITIALISED**     | The system creates the authorisation request.                                         |
| **PENDING**         | The customer needs to act on the authorisation request, and the bank must confirm it. |
| **SUCCESS**         | The customer successfully completes and approves the authorisation.                   |
| **FAILED**          | The authorisation request fails due to customer decline, timeout, or other errors.    |

## Subscription lifecycle

The table below describes the various states a subscription enters after creation:

| Subscription State        | Description                                                                                                                                                                                 |
| ------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **INITIALISED**           | The system creates the subscription but waits for customer authorisation.                                                                                                                   |
| **BANK APPROVAL PENDING** | The customer authorises the subscription, but the bank confirmation is still pending. This applies to NACH. It may take 24-48 hrs to change the status from BANK APPROVAL PENDING to ACTIVE |
| **ACTIVE**                | The bank fully authorises the subscription, making it ready for payment collection.                                                                                                         |
| **ON HOLD**               | The subscription goes on hold due to a failed recurring payment and resumes once reactivated. This applies to periodic mandates on NACH and Cards standing instructions payment methods.    |
| **PAUSED**                | The merchant pauses the subscription, applicable only for active periodic subscriptions.                                                                                                    |
| **COMPLETED**             | The subscription completes its cycle or reaches its expiry limit.                                                                                                                           |
| **CUSTOMER CANCELLED**    | The customer cancels the subscription at the bank. Canceled subscriptions can't resume.                                                                                                     |
| **CUSTOMER\_PAUSED**      | The customer pauses the subscription from their UPI app; only the customer can resume it.                                                                                                   |
| **EXPIRED**               | The subscription reaches its expiry date and stops processing payments.                                                                                                                     |
| **LINK EXPIRED**          | The authorisation link expires without successful completion by the customer; no further action is possible. This applies to non-seamless subscriptions created after May 4, 2023.          |
