> ## Documentation Index
> Fetch the complete documentation index at: https://www.cashfree.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Manage Subscriptions

> Manage Cashfree subscriptions: cancel active mandates to stop future charges, reactivate cancelled subscriptions, or stop pending charges before debit.

Manage your active subscriptions by updating their status, retrying failed charges, or modifying existing plans and amounts. You can perform these actions manually through the [Merchant Dashboard](https://merchant.cashfree.com/auth/login) or programmatically using the [Subscriptions APIs](/api-reference/payments/latest/subscription).

<Tabs>
  <Tab title="Dashboard">
    Manage your subscriptions manually through the [Merchant Dashboard](https://merchant.cashfree.com/auth/login).

    ### Cancel, pause, or reactivate subscriptions

    Update the status of your subscriptions to handle customer requests or manage temporary service suspensions.

    1. Log in to the [Merchant Dashboard](https://merchant.cashfree.com/auth/login) and go to **Subscriptions** > **All Subscriptions**.
    2. Select the specific subscription you want to manage.
    3. Select **Manage Subscriptions**.
    4. Choose the required action:
       * **Cancel**: Stops all future charges.
       * **Pause**: Temporarily stops billing until you resume it.
       * **Reactivate**: Resumes billing for a cancelled or paused subscription.

    ### Manage charges

    Manage individual payment cycles by cancelling pending charges or retrying failed transactions.

    The following options are available for managing a scheduled or failed charge:

    * **Cancel**: Stop a pending charge before it is debited.
    * **Retry**: Attempt to collect payment again for a failed charge cycle. If a charge fails due to insufficient funds, the subscription may move to `ON_HOLD`.
    * **Refund**: Issue [refunds](/payments/manage/refunds/overview) for successful subscription payments directly from the transaction details page.

    <Note>
      A maximum of 3 retries are allowed per billing cycle. The system stops further attempts once this limit is reached.
    </Note>

    <Tip>
      Customers can also pause or cancel a mandate directly from their UPI app or net banking portal.
    </Tip>
  </Tab>

  <Tab title="API">
    Automate your subscription lifecycle management using the following APIs:

    * **[Manage Subscription API](/api-reference/payments/latest/subscription/mandate/manage)**: Programmatically cancel, pause, activate, or change the plan associated with a subscription.
      * **To update the recurring amount**: Create a new [plan](/payments/subscription/introduction#plans) with the revised amount and use this API with the `CHANGE_PLAN` action.
      * **Constraints**: The `CHANGE_PLAN` and `PAUSE` actions are not supported for On-Demand Subscriptions.
    * **[Manage Payment API](/api-reference/payments/latest/subscription/payment/manage)**: Cancel or retry a specific charge before or after processing. A maximum of 3 retries are allowed per billing cycle.
    * **[Refund APIs](/api-reference/payments/latest/subscription/refund/create)**: Programmatically initiate and track refunds for subscription payments.

    <Tip>
      Configure [webhooks](/payments/subscription/webhooks) to receive real-time updates when a subscription status changes.
    </Tip>
  </Tab>
</Tabs>

<div class="hidden" data-table-of-contents="bottom">
  <p class="mt-4 font-medium flex items-center gap-2 related-docs-heading">
    <svg width="16" height="16" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true" class="w-4 h-4">
      <path d="M3 4h7a2 2 0 0 1 2 2v13a2 2 0 0 0-2-2H3z" />

      <path d="M21 4h-7a2 2 0 0 0-2 2v13a2 2 0 0 1 2-2h7z" />
    </svg>

    <span>Related topics</span>
  </p>

  <ul>
    <li><a href="/docs/api-reference/payments/latest/subscription/mandate/manage">Manage Subscription API</a></li>
    <li><a href="/docs/payments/subscription/create#subscription-lifecycle">Subscription Lifecycle</a></li>
    <li><a href="/docs/payments/subscription/import">Import Mandates</a></li>
    <li><a href="/docs/payments/subscription/webhooks">Subscription Webhooks</a></li>
    <li><a href="/docs/payments/subscription/faq">Subscription FAQs</a></li>
  </ul>
</div>