Offers

Razorpay Offers allows you to associate new orders with previously created offers and thus discount the order amount in accordance with certain rules.

Attribute

Notes

Validation

Mandatory

Dependency

Name

Friendly name for the offer, can be displayed on Checkout as well

Max length: 50

Yes

No

Display Text

Free text field, used to display a message on Checkout

Max length: 255

Yes

No

Start Time

If not set, the offer will start immediately upon creation

N/A

No

No

End Time

Provide this data for limited time offers

Any future timestamp.

No

No

Payment Method

Method for which offer is applicable. Can be left blank to apply offer on all methods

Possible values are all valid methods such as cards, emi, wallet, netbanking

No

No

Payment Method Type

For use with card method, to further define the card type

Possible values: debit, credit

No

Applicable if method is card

Payment Network

For use with card method, to further define the card network

Possible values are VISA, MasterCard, Maestro

No

Applicable if method is card

Issuer

Issuer of the payment method.

For cards and netbanking, this is the bank code of the issuing bank
For wallets, it is the code of the wallet provider

Possible values: HDFC, UTIB (card/netbanking), Freecharge, Airtelmoney (wallet)

No

Options based on method

IINs

For use with card method, to define the list of IINs on which the offer is applicable

Only 6 digit IINs are accepted

No

Applicable if method is card

No-Cost EMI

For use when merchant wants to subvent the EMI interest rate for consumers

Possible values: Yes, No

No

Applicable if method is emi

EMI Duration

For use with No-Cost EMI

Possible values: 3, 6, 9, 12, 18, 24 (Multiple Choice)

No

Applicable if No-Cost EMI is Yes

Minimum Order Amount

Minimum order amount on which the offer is applicable

Example: INR 500.00

No

No

Discount Type

Identify the discount type

Possible values: Percentage, Flat Discount

No

Not Applicable if No-Cost EMI is Yes

Discount Value

Rate of discount to be applied on the order amount.

OR

Flat discount to be applied on the order amount

Must be whole number percentages, i.e. decimal percentages such as 12.5% are not supported currently.
OR
Example: INR 100.00

No

Tied to Discount Type

Maximum Discount

Maximum discount amount that may be applied

Example: INR 20.00

No

Applicable if Discount Type is Percentage

Not Applicable if No-Cost EMI is Yes

Creation of an offer will result in an offer ID (eg. offer_6w6bmFIqLiOGVj), which can be used while creating an Order

Note To create an offer for your account,reach out to our Support Team with the desired offer details.

Types of Offers#

  • Customer Controlled
    As a merchant, you can allow the customer to select the offer while during the payment process using Razorpay Checkout. In this case, Razorpay Checkout will display all applicable offers from which a customer can select a single offer to complete payment.

  • Merchant Controlled
    As a merchant, you can enforce the customer to complete the payment using a specific payment method. In this case, Razorpay Checkout will permit only those payment methods that are permitted by the applied offer. For example, if the offer associated with an order is only applicable on card payments, Checkout displays only cards as the only available payment method.

Customer Controlled Offers#

Step 1: Order Creation#

To add an offer on an order, you can send the following extra attribute in the Order creation request

Name

Description

offers

Array of Offer IDs received in the previous step

discount

Flag to indicate if discount is to be applied by Razorpay or not. Possible values: 1(Discount not applied), 0(Discount applied)

Copycurl -u rzp_test_26ccbdbfe0e84b:69b2e24411e384f91213f22a \ https://api.razorpay.com/v1/orders \ -X POST \ --data "amount=10000" \ --data "currency=INR" \ --data "offer_id=offer_ANZoaxsOww2X53" \ this attribute is being phase out --data "discount=1" \ https://api.razorpay.com/v1/orders
Copy{ "id": "order_Ad0pTpdIt1t1e5", "entity": "order", "amount": 10000, "amount_paid": 0, "amount_due": 10000, "currency": "INR", "receipt": null, "offers": [ "offer_ANZoaxsOww2X53" ], "status": "created", "attempts": 0, "notes": [], "created_at": 1532423453 }

Step 2: Payment Request#

The Order ID obtained in the previous step can be passed to the Checkout form.

Checkout will display the offers associated with the order and allow the customer to select the specific offer to be applied on a payment.

The payment initiated in this fashion will be created with the discounted amount, i.e. after application of the offer. For example, if a 20% discount offer was applied on an order of amount 1000, then passing this order ID to checkout will result in a payment of amount 800.

Step 3: Capturing Payments#

Regular rules for capturing Order payment apply here as well, namely that a payment can be autocaptured or captured manually.

If the payment is to be captured manually, the original order amount will need to be sent, i.e. in the above example, to capture the payment, a capture request with amount set to 1000 would need to be sent.

Examples#

Card Offers with Discounting#

Netbanking Offers with Discounting#

Merchant Controlled Offers#

Step 1: Order Creation#

To enable discounting on an order, you can send the following extra attributes in the order creation request:

Name

Description

offer_id

Offer ID received in the previous step.

discount

Flag to indicate if a discount is to be applied by Razorpay or not. Possible values: 1(Discount not applied), 0(Discount applied).
Not applicable for No-Cost EMI offer.

Copyurl -u rzp_test_26ccbdbfe0e84b:69b2e24411e384f91213f22a \ https://api.razorpay.com/v1/orders \ -X POST \ --data "amount=10000" \ --data "currency=INR" \ --data "offer_id=offer_ANZoaxsOww2X53" \ this attribute is being phase out --data "discount=1" \ https://api.razorpay.com/v1/orders
Copy{ "id": "order_Ad0pTpdIt1t1e5", "entity": "order", "amount": 10000, "amount_paid": 0, "amount_due": 10000, "currency": "INR", "receipt": null, "offers": [ "offer_ANZoaxsOww2X53" ], "status": "created", "attempts": 0, "notes": [], "created_at": 1532423453 }

Step 2: Payment Request#

The Order ID obtained in the previous step can be passed to Checkout form

Checkout will permit only those payment methods that are permitted by the applied offer, i.e. if the offer associated with an order is only applicable on card payments, then checkout will only display one available payment method, that is, cards.

The payment initiated in this fashion will be created with the discounted amount, i.e. after application of the offer. For example, if a 20% discount offer was applied on an order of amount 1000, then passing this order ID to checkout will result in a payment of amount 800.

Step 3: Capturing Payments#

Regular rules for capturing Order payment apply here as well, namely that a payment can be autocaptured or captured manually.

If the payment is to be captured manually, the original order amount will need to be sent, i.e. in the above example, to capture the payment, a capture request with amount set to 1000 would need to be sent.

Creation of an order in this fashion will result in an order_id, which can then be used in the payment request.

Frequently Asked Questions#

  1. What is No-Cost EMI?
    No Cost EMI is an offer by which you pay your EMI provider only the product price, equally divided over your repayment timeline. For example, if you buy a Rs.18,000 item at a 6 month tenure, you will pay your EMI provider Rs.3,000 every month for 6 months, amounting to a total of Rs.18,000.

  2. Which payment methods can be used for No-Cost EMI?
    No cost EMI is available on credit cards from all major banks - Kotak, HDFC, Axis, Indusind, RBL, ICICI, Standard Chartered, YesBank and American Express.

  3. Will the customer's bank continue to charge them interest?
    Yes, the customer's bank will continue to charge them interest. However, this interest charge has been provided to the customer as an upfront discount at the time of purchase, effectively giving them the benefit of a No-Cost EMI.

  4. Who manages offer usage limitations?
    Merchant is expected to manage offer usage limitations. This can be achieved by passing the appropriate offer_ids at the time of creating an order.

  5. What kind of report is available for this feature?
    The report will be the same as the payment report with the additional fields: offer_id, offer_name, order_amount, discount_amount and emi_duration.

  6. How to manage offers without a discount?
    When the discount flag is set to 0 in the order creation request, the Order amount will not be discounted by Razorpay. However, the offer validations will still be applied.
    This can be used when the Order amount is already discounted by the Merchants and they want to use the Razorpay Offers platform to restrict the payment method to a specific one. This is similar to Merchant Controlled Offer.

  7. How to apply a discount and no-cost EMI in a single offer?
    Currently, a single offer can either provide a discount or no-cost EMI benefit but not both.

  8. Can you share a table that highlights the calculations for No-Cost EMI?
    Calculations on the cost incurred by the merchant at all standard plan and tenures are listed below:

    Amount (in INR)

    Interest (in %)

    Tenure (in Months)

    Amount Paid by Customer

    Monthly EMI

    No-Cost EMI Discount

    Discount

    Pricing

    Total Cost (in %)

    10000

    11%

    3

    9,819.43

    3333.33

    180.57

    1.81%

    3%

    4.81%

    10000

    12%

    3

    9,803.28

    3333.33

    196.72

    1.97%

    3%

    4.97%

    10000

    13%

    3

    9,787.18

    3333.33

    212.82

    2.13%

    3%

    5.13%

    10000

    14%

    3

    9,771.13

    3333.33

    228.87

    2.29%

    3%

    5.29%

    10000

    15%

    3

    9,755.11

    3333.33

    244.89

    2.45%

    3%

    5.45%

    10000

    11%

    6

    9686.85

    1666.67

    313.15

    3.13%

    3%

    6.13%

    10000

    12%

    6

    9659.13

    1666.67

    340.87

    3.41%

    3%

    6.41%

    10000

    13%

    6

    9631.53

    1666.67

    368.47

    3.68%

    3%

    6.68%

    10000

    14%

    6

    9604.04

    1666.67

    395.96

    3.96%

    3%

    6.96%

    10000

    15%

    6

    9576.68

    1666.67

    423.32

    4.23%

    3%

    7.23%

    10000

    11%

    9

    9556.66

    1111.11

    443.34

    4.43%

    3%

    7.43%

    10000

    12%

    9

    9517.80

    1111.11

    482.20

    4.82%

    3%

    7.82%

    10000

    13%

    9

    9479.17

    1111.11

    520.83

    5.21%

    3%

    8.21%

    10000

    14%

    9

    9440.77

    1111.11

    559.23

    5.59%

    3%

    8.59%

    10000

    15%

    9

    9402.61

    1111.11

    597.39

    5.97%

    3%

    8.97%

    10000

    11%

    12

    9428.80

    833.33

    571.20

    5.71%

    3%

    8.71%

    10000

    12%

    12

    9379.23

    833.33

    620.77

    6.21%

    3%

    9.21%

    10000

    13%

    12

    9330.04

    833.33

    669.96

    6.70%

    3%

    9.70%

    10000

    14%

    12

    9281.21

    833.33

    718.79

    7.19%

    3%

    10.19%

    10000

    15%

    12

    9232.76

    833.33

    767.24

    7.67%

    3%

    10.67%

    10000

    11%

    18

    9179.92

    555.56

    820.08

    8.20%

    3%

    11.20%

    10000

    12%

    18

    9110.15

    555.56

    889.85

    8.90%

    3%

    11.90%

    10000

    13%

    18

    9041.13

    555.56

    958.87

    9.59%

    3%

    12.59%

    10000

    14%

    18

    8972.85

    555.56

    1027.15

    10.27%

    3%

    13.27%

    10000

    15%

    18

    8905.30

    555.56

    1094.70

    10.95%

    3%

    13.95%

    10000

    11%

    24

    8939.84

    416.67

    1060.16

    10.60%

    3%

    13.60%

    10000

    12%

    24

    8851.41

    416.67

    1148.59

    11.49%

    3%

    14.49%

    10000

    13%

    24

    8764.21

    416.67

    1235.79

    12.36%

    3%

    15.36%

    10000

    14%

    24

    8678.23

    416.67

    1321.77

    13.22%

    3%

    16.22%

    10000

    15%

    24

    8593.43

    416.67

    1406.57

    14.07%

    3%

    17.07%

  9. Can you share a table with the credit card interest rates charged by the banks?
    The interest rates charged by the banks is listed below:

    Bank

    EMI Tenure

    Interest Rates

    Kotak

    3

    12%

    Kotak

    6

    12%

    Kotak

    9

    14%

    Kotak

    12

    14%

    Kotak

    18

    15%

    Kotak

    24

    15%

    HDFC

    3

    13%

    HDFC

    6

    13%

    HDFC

    9

    14%

    HDFC

    12

    14%

    HDFC

    18

    15%

    HDFC

    24

    15%

    Axis

    3

    12%

    Axis

    6

    12%

    Axis

    9

    13%

    Axis

    12

    13%

    Axis

    18

    15%

    Axis

    24

    15%

    IndusInd

    3

    13%

    IndusInd

    6

    13%

    IndusInd

    9

    13%

    IndusInd

    12

    13%

    IndusInd

    18

    15%

    IndusInd

    24

    15%

    RBL

    3

    13%

    RBL

    6

    13%

    RBL

    9

    13%

    RBL

    12

    13%

    RBL

    18

    13%

    RBL

    24

    13%

    ICICI

    3

    13%

    ICICI

    6

    13%

    ICICI

    9

    13%

    ICICI

    12

    13%

    ICICI

    18

    13%

    ICICI

    24

    13%

    Standard Chartered

    3

    13%

    Standard Chartered

    6

    13%

    Standard Chartered

    9

    14%

    Standard Chartered

    12

    14%

    YesBank

    3

    12%

    YesBank

    6

    12%

    YesBank

    9

    13%

    YesBank

    12

    13%

    YesBank

    18

    14%

    YesBank

    24

    15%

    Amex

    3

    12%

    Amex

    6

    12%

    Amex

    9

    12%

    Amex

    12

    12%

    Amex

    18

    12%

    Amex

    24

    12%