Fetch Offer API

Fetches offers without an existing order context. Used for offer discovery before order creation. Requires Air India travel context in offerParams.

Endpoint

Environment	Base URL
UAT / Test	`https://sandbox.payu.in/offers/transactions`
Production	`https://api.payu.in/offers/transactions`

Sample Request

curl -X POST 'https://sandbox.payu.in/offers/transactions' \
  -H 'Date: <rfc_1123_gmt_date>' \
  -H 'Digest: <base64_sha256_digest>' \
  -H 'Authorization: hmac username="<merchant_key>", algorithm="hmac-sha256", headers="date digest", signature="<base64_hmac_sha256_signature>"' \
  -H 'platformId: 1' \
  -H 'Content-Type: application/json' \
  -d '{
    "orderId": "PREVIEW_ORDER_001",
    "amount": 10000,
    "baseAmount": 9000,
    "userDetails": {
      "phoneNo": "8310300493",
      "email": "[email protected]"
    },
    "offerParams": {
      "passengers": [
        {
          "passengerTypeCode": "ADT",
          "gender": "MALE",
          "dateOfBirth": "1996-01-01"
        }
      ],
      "itineraries": [
        {
          "departureAirportCode": "DEL",
          "arrivalAirportCode": "BLR",
          "departureDate": "2025-12-18",
          "segments": [
            {
              "flightNumber": "AI2849",
              "cabin": "Economy",
              "fareClass": "YTRQOU"
            }
          ]
        }
      ],
      "paxCount": 1,
      "journeyType": "AI",
      "itineraryType": "oneway",
      "flowId": "WBPB001",
      "userId": "AIR_INDIA_USER_ID",
      "bookingDateTime": "2025-12-18 11:15:18",
      "officeDetails": {
        "id": "DELAI08AA"
      },
      "customerType": "REGISTERED",
      "loyaltyDetails": {
        "loyaltyId": "LOYALCUST123",
        "membershipTier": "RED"
      }
    }
  }'

Sample Response

{
  "code": "200",
  "message": "Offer Retrieved Successfully",
  "status": 1,
  "result": {
    "offers": [
      {
        "offerKey": "OFFER_KEY_123",
        "title": "10% Cashback",
        "description": "Get 10% cashback on Air India bookings",
        "discountDetail": {
          "discountType": "PERCENTAGE",
          "discountPercentage": 10.00
        }
      }
    ]
  },
  "traceId": "uuid-trace-id"
}

Request Parameters

Header Authentication Parameters

Parameter	Description	Example
Date `mandatory`	`string` Request date and time in RFC 1123 GMT format.	`Thu, 17 Feb 2022 08:17:59 GMT`
Digest `mandatory`	`string` Base64-encoded SHA-256 digest of the serialized JSON request body.	`vpGay5D/dmfoDupALPplYGucJAln9gS29g5Orn+8TC0=`
Authorization `mandatory`	`string` HMAC authorization value using the merchant key, the `hmac-sha256` algorithm, and the signed headers `date digest`.	`hmac username="<merchant_key>", algorithm="hmac-sha256", headers="date digest", signature="<base64_signature>"`
platformId `mandatory`	`string` Platform identifier. Set this value to `1`.	`1`
Content-Type `mandatory`	`string` Media type of the JSON request body.	`application/json`

Authentication

This API does not use HeaderAuthentication. Compute Digest as Base64(SHA-256(serialized JSON request body)). Then compute signature as Base64(HMAC-SHA256(date: {Date}\ndigest: {Digest}, merchant salt)) and send Authorization with algorithm="hmac-sha256" and headers="date digest".

Body Parameters

Parameter	Description	Example
orderId `mandatory`	`string` Temporary/preview order ID.	`PREVIEW_ORDER_001`
amount `mandatory`	`number` Total transaction amount.	`10000`
baseAmount `mandatory`	`number` Base transaction amount.	`9000`
paymentId `optional`	`number` Payment identifier.	`123`
offerKeys `optional`	`array` Specific offer keys to evaluate (null for all).	`null`
userDetails `optional`	`object` User information. See userDetails object parameters for details.	-
offerParams `mandatory`	`object` Air India specific travel context. See offerParams object parameters for details.	-

userDetails object parameters

Parameter	Description	Example
userToken `optional`	`string` User token.	`abcd`
phoneNo `optional`	`string` User phone number.	`8310300493`
email `optional`	`string` User email.	`[email protected]`
loggedInPhoneNumber `optional`	`string` Logged-in user's phone number.	`8310300493`

offerParams object parameters

Air India specific travel context:

Parameter	Description	Example
passengers `mandatory`	`array` List of passengers. Each passenger object contains passengerTypeCode (ADT/CHD/INF), gender, dateOfBirth.	-
itineraries `mandatory`	`array` Flight itineraries. Each itinerary contains departureAirportCode, arrivalAirportCode, departureDate, segments array.	-
paxCount `mandatory`	`number` Total passenger count.	`1`
journeyType `mandatory`	`string` Journey type. For Air India, use `AI`.	`AI`
itineraryType `mandatory`	`string` Type of itinerary: `oneway`, `roundtrip`, `multicity`.	`oneway`
flowId `mandatory`	`string` Flow identifier.	`WBPB001`
userId `optional`	`string` Air India user ID.	`AIR_INDIA_USER_ID`
bookingDateTime `mandatory`	`string` Booking timestamp.	`2025-12-18 11:15:18`
officeDetails `mandatory`	`object` Office/agent details with field: id.	`{"id": "DELAI08AA"}`
customerType `optional`	`string` Customer type: `REGISTERED` or `GUEST`.	`REGISTERED`
customerDetails `optional`	`object` Customer contact details with fields: customerEmail, customerPhone.	-
loyaltyDetails `optional`	`object` Loyalty program information with fields: loyaltyId, membershipTier, emailId, phoneNumber.	-

Response Parameters

The response structure is the same as Fetch Offer (with Order ID) API. Refer to that documentation for detailed response parameters.

Parameter	Description	Example
code	`string` Response code.	`200`
message	`string` Response message.	`Offer Retrieved Successfully`
status	`number` Status indicator. `1` = success, `0` = failure.	`1`
result	`object` Contains offer details including offers array.	-
traceId	`string` Unique trace ID for debugging.	`uuid-trace-id`

Updated about 1 hour ago

Did this page help you?