---
url: /cashfree-acellemail/guides/set-up-subscriptions.md
description: >-
  Create a plan in Cashfree, copy its plan_id into the Cashfree Subscription
  gateway, then map your AcelleMail plan to it in Remote Plan Mappings so
  recurring billing works.
---

# Set up subscriptions

The **Cashfree Subscription** gateway handles recurring billing via UPI AutoPay, eNACH, and card mandates. Because Cashfree lacks an automated plan-discovery API, plans must be created in Cashfree and mapped locally in AcelleMail.

::: info INR-only
Cashfree Subscriptions are **INR-only** — only INR-priced plans are eligible. A plan in any other currency won't map.
:::

## 1. Create the plan in Cashfree

**Cashfree Dashboard → Subscriptions → Plans** → create each recurring plan (amount, interval, currency INR). When saved, copy its **`plan_id`**.

## 2. Paste the plan IDs into the gateway

1. Navigate to **Admin → Payment Gateways → Cashfree Subscription → Edit**.
2. Enter your Cashfree `plan_id` values (**one per line**) into the **Cashfree Plan IDs** field.
3. Save changes to whitelist these plans for recurring billing.

## 3. Map each local plan

1. Open **Admin → Remote Plan Mappings**.
2. Pair each AcelleMail plan with its matching Cashfree `plan_id` and click **Map**.
3. **Match requirements:** Local and remote plans **must have identical currency and pricing**.

![Mapping AcelleMail plans to Cashfree plan IDs](/cashfree-acellemail/img/cashfree-set-up-subscriptions-plan.png)
*Admin → Remote Plan Mappings*

Only **mapped, INR-priced** plans expose the Subscription gateway to customers. An unmapped or non-INR plan is simply not offered the Cashfree Subscription option at checkout.

## What the customer sees

Customers are redirected to Cashfree's hosted page to **"Authorize ₹:amount recurring mandate"**. Once authorized, renewals process automatically via webhook notifications without customer intervention.

::: tip Recurring debit windows
Per NPCI rules, recurring debits run **outside** the non-peak windows — that is, **not** during 10 AM–1 PM or 5 PM–9:30 PM IST. A renewal may land just outside those hours.
:::

## Related pages

* [Subscriptions](/cashfree-acellemail/features/subscriptions)
* [Get your API keys](/cashfree-acellemail/guides/get-api-keys)
* [Configure webhooks](/cashfree-acellemail/guides/configure-webhooks)
* [Going live](/cashfree-acellemail/guides/going-live)
* [Troubleshooting](/cashfree-acellemail/troubleshooting)