SKU and Brand Offers

Available in🇮🇳 India

SKU and Brand Offers let you attach offers to individual products (SKUs) in an order instead of the whole cart. For example, a customer buying a laptop and a mouse can get ₹3,000 off the laptop and ₹2,000 off the mouse in a single checkout session. Both merchant-funded offers and brand-funded offers, such as a brand’s bank discount on a specific phone model, are supported. You send the cart’s SKUs in the order. Razorpay Standard Checkout finds the offers that match those SKUs, shows them to the customer and applies the best offers automatically. To show these offers on your own website or app before checkout, for example on product pages, use the Fetch and Match Offers APIs.

Feature RequestThis is an on-demand feature. Contact your Razorpay account manager to enable SKU and Brand Offers on your account. Razorpay configures the offers and the SKUs they apply to for you. SKU and Brand Offers on Standard Checkout work in both test mode and live mode, so you can test your integration before you go live.

Availability

	Supported
Platforms	Standard Checkout on web, Android and iOS. Shopify and Magento plugins. Payment Links.
Payment methods	Cards and EMI.

Customer Experience

Checkout stage	What the customer sees
Checkout opens	Cart items with SKU names and quantities. Offers that apply to those SKUs are highlighted.
Selects a payment method	The best offers for that payment method are applied automatically.
Completes the payment	The discount is deducted from the amount payable. The success screen shows the savings for each item.

Watch this video to see SKU and Brand Offers on Standard Checkout. The customer sees the offers for each product in the cart, the best offers are applied automatically and the order summary shows the discount on each item.

How It Works

Your backend makes the API calls. Standard Checkout handles everything in between.

#	Actor	Action	API or mechanism
1	Customer	Adds products to the cart and clicks Pay.	—
2	Your backend	Creates an order with `line_items`.	Create an Order
3	Your frontend	Opens Standard Checkout with the `order_id`.	Standard Checkout
4	Razorpay	Loads the offers that apply to the SKUs in the order.	Automatic
5	Customer	Selects a payment method and enters the payment details.	—
6	Razorpay	Applies the best offers.	Automatic
7	Customer	Clicks Pay Now.	—
8	Razorpay	Processes the payment and sends the `payment.authorized` webhook.	Webhook
9	Your backend	Fetches the order to confirm which offers were applied.	Fetch Order

Integration Steps

Step 1: Create an Order With Line Items

When the customer clicks Pay, create an order using the Orders API and pass every SKU in the cart in the line_items array. Razorpay matches offers using these line items, so include all SKUs with accurate prices and quantities.

Watch Out!The order amount must equal the total of price × quantity across all line_items. For example, a smartphone at ₹40,000 and earbuds at ₹15,000 make an order amount of 5500000 (₹55,000).

POST /v1/orders

Curl

curl -u [YOUR_KEY_ID]:[YOUR_KEY_SECRET] \
-X POST https://api.razorpay.com/v1/orders \
-H "content-type: application/json" \
-d '{
  "amount": 5500000,
  "currency": "INR",
  "receipt": "receipt_order_001",
  "line_items": [
    {
      "sku": "SKU001",
      "brand": "acme",
      "name": "Smartphone 128 GB",
      "price": 4000000,
      "quantity": 1,
      "image_url": "https://example.com/images/smartphone.jpg"
    },
    {
      "sku": "SKU002",
      "brand": "acme",
      "name": "Wireless earbuds",
      "price": 1500000,
      "quantity": 1,
      "image_url": "https://example.com/images/earbuds.jpg"
    }
  ]
}'

Request Parameters

integer

required

Total order amount in paise. It must equal the total of price × quantity across all line_items. For example, pass 5500000 for ₹55,000.

string

required

Currency of the order. Possible value is INR.

string

Your internal order reference for reconciliation. Maximum length is 40 characters and it must be unique.

array

required

The products in the customer’s cart.

string

required

SKU identifier of the product. It must match the SKU configured in the offer.

string

required

Brand of the product. For example, apple. Not case-sensitive. Brand offers are evaluated correctly only when you pass it.

integer

required

Unit price of the product in paise.

integer

required

Number of units of the product.

string

Name of the product. Shown to the customer on Checkout.

string

Public URL of the product image.

Response

{
  "id": "order_DtEkng132N71M8",
  "entity": "order",
  "amount": 5500000,
  "amount_paid": 0,
  "amount_due": 5500000,
  "currency": "INR",
  "receipt": "receipt_order_001",
  "offers": ["offer_DtEhEm3XslgfXE"],
  "status": "created",
  "attempts": 0,
  "created_at": 1748750400
}

Response Parameters

string

Unique identifier of the order. Pass this to Standard Checkout.

string

Status of the order. It is created when the order is created successfully.

array

Identifiers of the offers that apply to the SKUs in this order.

string

Your internal order reference, returned as sent.

Step 2: Open Standard Checkout

Open Standard Checkout with the order_id from Step 1. You do not need to pass offer IDs. Checkout reads the line_items on the order and fetches and displays the offers that apply.

Checkout Options

var options = {
  key: "YOUR_KEY_ID",
  order_id: "order_DtEkng132N71M8", // id from the Create Order API response
  name: "Acme Corp",
  // prefill, theme and handler as per your integration
};
var rzp = new Razorpay(options);
rzp.open();

Watch Out!The discount breakdown for each SKU is shown only inside Standard Checkout. The Create Order API response returns only the offers that apply to the order. To confirm which offers were applied after the payment, fetch the order.

Step 3: Handle the payment.authorized Webhook

Razorpay sends the payment.authorized webhook to your endpoint after the payment is processed. Set up your webhook endpoint on the Dashboard. Your endpoint must return HTTP 200. Otherwise, Razorpay retries the delivery. Know more about webhook delivery and retries.

Sample Payload

{
  "entity": "event",
  "account_id": "acc_BFQ7uQEaa6Kdt8",
  "event": "payment.authorized",
  "contains": ["payment"],
  "payload": {
    "payment": {
      "entity": {
        "id": "pay_A1B2C3D4E5F6G7",
        "entity": "payment",
        "amount": 5000000,
        "currency": "INR",
        "status": "authorized",
        "order_id": "order_DtEkng132N71M8",
        "method": "card",
        "captured": false,
        "created_at": 1748750600
      }
    }
  }
}

Field	Description
`payload.payment.entity.id`	Payment ID. Use it to capture or refund the payment.
`payload.payment.entity.order_id`	The order this payment belongs to.
`payload.payment.entity.amount`	Amount charged in paise, after the discount.
`payload.payment.entity.status`	`authorized` means the payment succeeded. Capture the payment if it is not captured automatically.

Step 4: Fetch the Order to Confirm Applied Offers

After you receive the payment.authorized webhook, fetch the order with expand[]=offers. The response shows the final order state, the offers applied and the discount on each SKU. Use it for fulfilment, CRM and reconciliation.

Handy TipsCall this API only after you receive the payment.authorized webhook. The order status and applied offers are final only once the payment is authorised.

GET /v1/orders/:id?expand[]=offers

Curl

curl -u [YOUR_KEY_ID]:[YOUR_KEY_SECRET] \
-X GET 'https://api.razorpay.com/v1/orders/order_DtEkng132N71M8?expand[]=offers'

Response

{
  "id": "order_DtEkng132N71M8",
  "entity": "order",
  "amount": 5500000,
  "amount_paid": 5000000,
  "amount_due": 0,
  "currency": "INR",
  "receipt": "receipt_order_001",
  "status": "paid",
  "attempts": 1,
  "notes": {},
  "offers": ["offer_DtEhEm3XslgfXE"],
  "offers_applied": {
    "entity": "collection",
    "count": 1,
    "items": [
      {
        "id": "offer_DtEhEm3XslgfXE",
        "status": "redeemed",
        "benefits": [
          {
            "type": "instant_discount",
            "applicable_on": "line_item",
            "calculated_benefit_value": 500000,
            "benefit_breakup": [
              {
                "sku": "SKU001",
                "brand": "acme",
                "applied_quantity": 1,
                "calculated_benefit_value": 500000
              }
            ]
          }
        ]
      }
    ]
  },
  "created_at": 1748750400
}

Response Parameters

string

Unique identifier of the order.

integer

Original order amount in paise, before discounts.

integer

Amount charged to the customer in paise, after discounts.

integer

Amount still due in paise. It is 0 for a fully paid order.

string

Status of the order. Possible values are created, attempted and paid.

object

Key-value pairs of notes for the order.

array

IDs of the offers on the order, including the ones in offers_applied.

object

Applied offers: entity (always collection), count and items. Returned when you pass expand[]=offers.

string

Identifier of the applied offer.

string

redeemed means the offer was applied successfully.

array

Benefits applied by this offer.

type: Benefit type. Possible values are instant_discount, cashback, no_cost_emi, low_cost_emi and already_discounted.
applicable_on: line_item for an SKU-level offer or cart for a cart-level offer.
calculated_benefit_value: Total benefit amount from this benefit in paise.
benefit_breakup: Benefit on each SKU, with sku, brand, applied_quantity and calculated_benefit_value. Present only for line_item benefits.

The API returns these responses without an error:

Scenario	Behaviour
`expand[]=offers` is not passed	`offers_applied` is not included.
No offers were applied to the order	`offers_applied.count` is `0`.
The order is in `created` state and the payment is not complete	Order details are returned and `offers_applied` is empty.