API ReferenceIntegrationsKnowledge Base

About Offers

You can use Subscription Offers to provide discounts or cashback on Subscriptions. This attracts more customers, retains existing customers and increases sales. You have complete control over the offers you provide to your customers such as the payment methods on which the offer should be applied, maximum number of customers who can avail the offers and define the time of offers.

How are Discounts Calculated🔗

There are 2 types of discount calculations:

Percentage Discount Calculations🔗

Let us say you sell keto meals.

  • Plan amount = ₹1,000/month
  • Quantity = 2 units
  • Upfront amount (delivery fee) = ₹250/month
  • Add-on (keto chips) = ₹250/month
  • You offer a 10% discount up to ₹300.
CopyTotal amount = (Plan amount x Quantity) + Upfront Amount + Add-ons Total amount = (₹1,000 x 2) + ₹250 + ₹250 Total amount = 2,500 Discount amount = Total amount x Discount percentage Discount amount = ₹2,500 x 10% Discount amount = ₹250

Flat Discount Calculations🔗

Let us say you sell keto meals.

  • Plan amount = ₹1,000/month
  • Quantity = 2 units
  • Upfront amount (delivery fee) = ₹250/month
  • Add-on (keto chips) = ₹250/month
  • You offer a flat discount of ₹150.
CopyTotal amount = (Plan amount x Quantity) + Upfront Amount + Add-ons Total amount = (₹1,000 x 2) + ₹250 + ₹250 Total amount = 2,500 Discount amount = ₹150

Subscription Offers States🔗

A Subscription offer has 2 states:

  • Enabled: The offer is active and available to your customers.
  • Disabled: The offer is disabled and no longer available to your customers.
offers life cycle

Customise Subscription Offers🔗

There are 3 main parameters that you can use to customise and control offers:

Apart from the above, you can use other parameters to configure attributes such as the start and end dates and the number of times the offer can be used.

Subscription Offer Types🔗

Following are the 3 types of offers you can create for Subscriptions:

Subscription Offer Type

Description

Single Use

This is a one-time discount offered to the customer.

Limited number of cycles

You can specify the number of cycles the offer should be applied.
For example, you can apply an offer for the first 3 cycles of a 12-month Subscription.

Forever

The offer is applied for the entire duration of the Subscription.

Discount Type🔗

Following are the 2 types of discounts you can provide on Subscription offers:

Discount Type

Description

Flat

A flat discount is offered to the customer.

Percentage

The discount offered is a percentage of the Subscription amount.

Watch Out!
Offers can only be applied if the chargeable amount after applying the offer is greater than ₹1.

Payment Methods🔗

Following are the 2 payment methods available for offers on Subscriptions:

Payment Method

Description

Card

Offers will be applied to Subscriptions paid using cards. The options available for cards are listed below:
Card type: Credit card, debit card or both.
Bank: Card issuing bank. For example, HDFC Bank, Axis Bank. You can select 1 bank or all available banks. You cannot select multiple banks.
Network: Card network. For example, Visa, RuPay. You can select 1 network or all available networks. You cannot select multiple networks.
Max Usage Per Card: How many times a particular card be used to avail the offer.
IINs: The card IINs on which the offer should be applied. You can enter multiple IINs separated by commas.

UPI

Offers will be applied to Subscriptions paid using UPI apps.

Other Parameters🔗

Listed below are the other parameters available to you when creating an offer:

Parameter

Description

Offer Name

A name for the offer. This appears on the checkout. For example, Monsoon Offer.

Display Text

A description of the offer. This appears on the checkout. For example, 10% discount on all card payments.

Terms

Terms and conditions of the offer.

Starting On

The date and time from which the offer will appear on the checkout.

Expires On

The date and time at which the offer will no longer appear on the checkout.

On Payment Failure

What happens when an offer validation (such as payment method) fails. You can:
● Allow the customer to complete the payment without the offer.
● Do not allow the payment to go through.

Max Usage

The number of time the offer can be used.
For example, you can use this parameter to limit the offer to the first 100 customers.

×