With Cashfree Subscriptions, you can easily create and manage subscriptions for your customers and charge them automatically as per the plan and the charge model defined.
The subscription service is available through the Dashboard and APIs.
With Cashfree Subscriptions, you can do automatic debits from your customers. The customer does not have to intervene with the payments after the initial checkout is completed.
The following points help you understand our workflow better:
You must first create a plan for the agreed duration using the charge model that is applicable for each customer.
Create a subscription with the plan and share the link with the customer.
Customer completes the checkout. After successful checkout, the subscription will be active till the duration that has been agreed with your customer.
Cashfree offers two charge models that you can use to charge the customers, Periodic and On-Demand.
Customers will be charged a fixed amount at fixed intervals (Daily, Weekly, Monthly, Yearly) for the goods/services that you provide. Specify the amount and the charge frequency to create a plan using the periodic charge model. Example: For SIP payments where customers must make the payment on the same date month-wise. Cashfree schedules the payment as per the plan, and the fixed amount gets debited from the customer account.
When subscriptions do not have a fixed period or a fixed amount, you can use this charge model. Example: Wallet recharges - when the balance reaches the minimum required amount, you can enable auto-recharge for customers using subscriptions.
For on-demand subscriptions when you have a large number of subscriptions to be charged, you can upload a file with all the details and charge all your customers at once using the Bulk Payments feature.
Before you create subscriptions for your customers, create a plan and specify the charge model which works for your customers.
To create a plan,
Go to PG Dashboard > Subscriptions > Plans > New Plan.
Enter a Plan ID to identify the plan when you create a subscription.
Enter a Plan Name for easy reference.
Enter a Description for the plan. The details you enter here will be visible to your customers during checkout.
Select Plan Type. It can be a Periodic or an On-demand plan.
For periodic plans select the Interval Type (monthly, weekly, etc.)
Specify the Amount to be charged. For on-demand plan type, specify the Max Amount that a customer can be charged for this plan.
Click Create. A plan has been created and you can create subscriptions using this plan.
Every subscription should have a plan. You can define the duration and the amount which you will charge your customers in the plan.
Create subscriptions and share the link with customers
Customer complete the checkout and subscription will be active
After you have created the plan, the next step is to create a subscription to charge the customers as per the plan created.
To create a new subscription,
Go to PG Dashboard > Subscriptions > View Subscriptions > New Subscription.
Enter a unique Subscription Id. This is used to identify each subscription.
Select the Plan which you have already created. Click here to know how to create a plan.
Enter the Customer Email and Customer Phone.
Enter the Expiry Date, the last date till the subscription is valid.
In the Note field, enter a brief description for the subscription. Customers can view this during checkout.
Enter the Return URL to which customers will be redirected after the subscription has been authorized.
Click Create. The subscription has been created, and you can share the subscription authorization link with the customers. Customer can provide their card details/account number and authorize the subscription.
For the checkout to be successful, your customers must authorize the subscription using the link shared. You can use our standard checkout flow or you can customise the checkout experience for your customers as per your requirements. Auto-debits will be enabled only after successful authorization. It saves customers the time and effort to make periodic payments. The payment gets debited automatically based on the plan created.
Customers can select one of the following payment methods for subscriptions:
Bank Account (e-Mandate)
Customers can authorize the subscriptions using their bank account via net banking or debit card. They must enter their bank account details and authorize the subscription. The payment gets debited automatically based on the plan selected.
To authorize using a bank account,
Customers must select the Bank Account (e-Mandates) payment method on the checkout page.
Select the preferred authorization mode, either Net Banking or Debit Card.
Enter the required details, and approve the subscription.
EQUITAS SMALL FINANCE BANK LTD
BANK OF BARODA
CENTRAL BANK OF INDIA
HDFC BANK LTD
CITY UNION BANK LTD
IDBI BANK LTD
CITIBANK N A
DCB BANK LTD
ICICI BANK LTD
BANDHAN BANK LTD
DEUTSCHE BANK AG
INDIAN OVERSEAS BANK
EQUITAS SMALL FINANCE BANK LTD
KARNATAKA BANK LTD
BANK OF MAHARASHTRA
KOTAK MAHINDRA BANK LTD
PUNJAB NATIONAL BANK
JANA SMALL FINANCE BANK LTD
PAYTM PAYMENTS BANK LTD
THE HONGKONG AND SHANGHAI BANKING CORPORATION LTD
RBL BANK LIMITED
SOUTH INDIAN BANK
STATE BANK OF INDIA
PUNJAB AND SIND BANK
STANDARD CHARTERED BANK
KARUR VYSA BANK
TAMILNAD MERCANTILE BANK LTD
DBS BANK INDIA LTD
UJJIVAN SMALL FINANCE BANK LTD
Customers can authorize the subscriptions using their debit/credit card. They must enter their card details like card number, cardholder name, card validity details and authorize the subscription. The payment gets debited automatically based on the plan selected.
Payments through all major credit cards are supported. For debit cards, payments through ICICI Bank, Kotak Mahindra Bank, Citibank, Canara Bank, and Standard Chartered Bank are supported.
Once the customer has authorized the subscription, you can easily debit their account either periodically or as per the on-demand plan. In the case of a periodic plan, Cashfree will auto-debit the customer’s account as per the plan interval. For an On-Demand plan, you have to send an API request to Cashfree every time you want to debit your customers. Your customers are notified when the payment gets debited.
For an On-Demand plan, you would have to raise a Payment every time you want to debit your customers. You can raise a payment using any of the following methods:
Through API request - Charge Subscription.
Through the dashboard for individual customers. Go to Subscriptions > View Subscriptions > Details (for the selected subscription) > ACTIONS > On Demand Charge.
Through the dashboard to initiate payment charges in bulk using the Bulk Payments feature. Go to Subscriptions > Bulk Payments > Upload .csv file with all the details.
If the payment fails due to insufficient funds, expiration of payment method, and so on, the status of the subscription changes to
ON-HOLD. In these scenarios, you can retry the failed transaction from the dashboard or using the retry API. If the retry is successful, the subscription will be activated, else it continues to be in the
To cancel a subscription, go to the PG Dashboard > Subscriptions > View Subscriptions > Subscription Details > click Cancel. The customer will no longer be charged.
For On-Demand subscriptions, when you want to initiate a large number of payments for multiple subscriptions, you can use the Bulk Payments feature.
To upload a bulk payment file for on-demand subscriptions,
Go to PG Dashboard > Subscriptions > Bulk Payments > click UPLOAD FILE.
Download the sample format. This is the format in which you need to provide the payment details.
Fill in the details and save the file.
Click CHOOSE FILE to select the file and then click UPLOAD.
Click DOWNLOAD to see if the payment was successfully initiated.