Coupons & promotions
A welcome worth using. A gift worth adding to the basket. Turn your next promotion into a reason to say yes, with the rules to make it yours.
Coupon codes · Automatic promotions · One connected cart
From first hello to a bigger basket
Three moments · One connected cart
Illustrative offers · Prices before shipping and taxes
The right incentive
Start with an incentive. Make the basket bigger. Watch your offer take shape, with every threshold and limit in your hands.
Offer a percentage discount across your catalogue, selected products, or categories. Set a cap to keep the saving within your plan.
20% off from ₹1,500 · Maximum saving ₹750
WEEKEND20 qualifies. You save ₹500.
Illustrative calculations in INR, excluding taxes. Your storefront uses the eligibility and final amounts returned by the cart API. Explore all coupon types
Connect a qualifying purchase to a free or discounted item.
Add a reward based on eligible spend or quantity.
Define product discounts at different quantity levels.
Use an accelerated-rewards coupon to offer bonus loyalty points.
Connected to checkout
This is where the offer becomes a clear saving. Follow the code from eligibility to an updated cart, with automatic promotions reflected along the way.
Evaluate coupons against a cart. Get applicable offers with estimated savings, plus reasons and suggestions for those that do not qualify.
GET/carts/{id}/evaluate-couponsInteractive example · INR · Excludes taxes
Example coupon is eligible for this basket.
Review coupon redemption counts and values over time. Look up the orders and customers associated with a coupon to understand how it was used.
Explore coupon reportingThe practical details
Answers for the teams planning the campaign and the developers building the checkout.
A coupon is applied using a code. An automatic promotion is reflected in the returned cart when its conditions are met. Both let you define offer conditions; their available types and combination settings differ.
Read the cart guide (opens in new tab)Coupons support percentage or fixed-amount discounts, tiered discounts, free goods, fixed-price offers, free shipping, Buy X Get Y, volume-based offers, and accelerated rewards. Automatic promotions, which need no code, support discounts, free goods, Buy X Get Y, volume-based offers, and free shipping.
Browse coupon types (opens in new tab)You control whether a coupon can be used with a promotion and whether a promotion can combine with other promotions. Promotions also have a priority setting. This does not imply that multiple coupon codes can be stacked on a single cart.
Yes. Eligibility can target specific customers, segments, or customer groups, with a separate first-time-customer condition. Offers that depend on customer history or group membership may require the shopper to log in.
Set a start timestamp and an optional expiry, plus limits for total redemptions, redemptions per customer, and redemptions per code. Coupons are created as drafts; activate them through the update flow when they are ready.
The evaluation APIs return applicable and inapplicable offers. Inapplicable coupons include reason and suggestion fields; applicable coupons include estimated discounts and savings messages. Use these responses to explain eligibility, then use the cart response for final amounts.
See coupon evaluation (opens in new tab)The coupon metrics API provides redemption counts and redemption values for a date range, with hourly, daily, weekly, or monthly aggregation. Admin endpoints also list the customers and orders associated with a coupon.
See coupon metrics (opens in new tab)Have a particular campaign in mind? Talk it through with us (opens in new tab)
A little extra goes a long way
Bring the campaign you have in mind. Let’s shape the incentive, the rules, and the checkout that bring it to life.
