SKU-Based Offer using Merchant Hosted Checkout

After you create a SKU-based offer on PayU Dashboard, you can start collecting payments for products with SKU-based offer. For more information on creating a SKU-based offer, refer to Create a SKU-Based Offer.

📘

Note:

For payment journey of instant discount offers using Merchant Hosted Checkout, refer to Instant Discount or Cashback using Merchant Hosted Checkout.

Steps to integrate

1. Fetch offers
2. Validate offer
3. Payment request
4. Check the response from PayU

Step 1: Fetch offers

Additional request parameter skusDetail for SKU

In addition to the request parameters listed in the Fetch Offers API section, the skusDetail parameter is posted with the following fields are posted in an array:

skusDetail parameter in sample request

The sample request posted will include the skusDetail parameter similar to the following:

"skusDetail": [
    {
      "skuAmount": 600,
      "quantity": 3,
      "skuId": "123",
      "offerKeys": null
    }

Sample Response

"skusDetail": [
    {
      "skuAmount": 600,
      "quantity": 3,
      "skuId": "123",
      "offerKeys": null
    }

Step 2: Validate Offer

Additional request parameters

In addition to the request parameters listed in Validate Offer API, the skusDetail parameter with skus in an JSON array is posted, where each skus contain the following fields are posted in an array:

skusDetail Object in request

  "skusDetail": {
    "skus": [
      {
      "autoApply": false,
        "skuAmount": 1000,
        "offerKeys": [
          "SummerSpecialOffer2021@q1Bh0jsogwqP"
        ],
        "quantity": 1,
        "skuId": "1"
      }
    ]
  }

skusDetail Object in response

        "skusDetail": {
            "skusDiscountDetail": {
                "totalCashbackDiscount": null,
                "totalInstantDiscount": 100,
                "totalDiscountedAmount": 900
            },
            "skus": [
                {
                    "skuId": "1",
                    "quantity": 1,
                    "name": "One Plus",
                    "skuAmount": 1000,
                    "isValid": true,
                    "autoApply": false,
                    "discountDetail": {
                        "offerKey": "SummerSpecialOffer2021@q1Bh0jsogwqP",
                        "offerType": "INSTANT",
                        "discount": 100,
                        "discountedAmount": 900,
                        "discountType": "PERCENTAGE"
                    },
         "offerDetail":{
         "offerId":10005,
         "offerKey":"SummerSpecialOffer2021@q1Bh0jsogwqP",
         "offerType":"INSTANT",
         "title":"SummerSpecialOffer",
         "description":"SummerSpecialOffer discount",
         "validFrom":"2021-07-01 17:02:11",
         "validTo":"2022-08-05 15:53:16",
         "tnc":"abc",
         "tncLink":"abcd",
         "discountType":"ABSOLUTE",
         "offerPercentage":null,
         "maxDiscountPerTxn":100.00,
         "minTxnAmount":10.00,
         "maxTxnAmount":25000.00,
         "status":"ACTIVE",
         "isNce":false,
         "disallowTransactionInvalidOffer": false,
         "isSkuOffer": true,
         "isSubventedOffer": true
      }

Step 3: Payment request

Additional request parameters for SKU-Based offer

📘

Reference:

For the checkout flow and list of request parameters required for the Offer integration, refer to Instant Discount or Cashback using Merchant Hosted Checkout.

Notes:

• The following order must be used for hashing:
  key|txnid|amount|productinfo|firstname|email|udf1|udf2|udf3|udf4|udf5|udf6|udf7|udf8|udf9|udf10|offer_key|offer_auto_apply|SALT
  For more information on hash generation process, refer to Hashing Request and Response.
• If any of the keys is null/not configured, "|" character must be concatenated.
• The above hash logic is for _payment API version 10 or later.

cart_details Object in sample request

"cart_details": {
    "amount": 55000,
    "items": 2,
    "sku_details": [
      {
        "sku_id": "smartphone234",
        "sku_name": "Smartphone",
        "amount_per_sku": "45000",
        "quantity": 1,
        "offer_key": null,
        "offer_auto_apply": true
      },
      {
        "sku_id": "smartwatch132",
        "sku_name": "Smartwatch",
        "amount_per_sku": "10000",
        "quantity": 1,
        "offer_key": [
          "flat500@2022"
        ],
        "offer_auto_apply": false
      }
    ]
  }

Step 4: Check the response from PayU

You need to look for the skusDetail object in the response. For the complete response, refer to Merchant Hosted Checkout.

Success scenario

The skusDetail JSON in the following sample response:

{"cart_details": {
    "id": "18",
    "payu_id": "999000000000983",
    "total_items": "2",
    "total_cart_amount": "55000",
    "offer_applied": null,
    "offer_availed": null,
    "instant_discount": "1000",
    "cashback_discount": "500",
    "total_discount": "1500",
    "net_cart_amount": "54000",
    "created_at": null,
    "updated_at": null,
    "sku_details": [
      {
        "id": "35",
        "cart_id": "18",
        "payu_id": "999000000000983",
        "mid": "180012",
        "sku_id": "smartphone234",
        "sku_name": "Smartphone",
        "amount_per_sku": "45000.00",
        "quantity": "1",
        "amount_before_discount": "45000",
        "discount": "1000",
        "amount_after_discount": "44000",
        "offer_key": null,
        "offer_status": null,
        "offer_type": null,
        "created_at": null,
        "updated_at": null
      },
      {
        "id": "36",
        "cart_id": "18",
        "payu_id": "999000000000983",
        "mid": "180012",
        "sku_id": "smartwatch132",
        "sku_name": "Smartwatch",
        "amount_per_sku": "10000.00",
        "quantity": "1",
        "amount_before_discount": "10000.00",
        "discount": "500",
        "amount_after_discount": "10000.00",
        "offer_key": null,
        "offer_status": null,
        "offer_type": null,
        "created_at": null,
        "updated_at": null
      }
    ]
  }}

Step 5: Verify the payment

Verify the payment using the Verify Payment API. For the sample response using the Verify Payment API from PayU involving offers, refer to Additional Info for General APIsI.