List Gift Card Brands

GET https://pay2new.in/apis/v1/giftcards/brands

Retrieve the current available catalogue and the savings/commission display rate for your authenticated account. Shopping gift cards and OTT/subscription products are returned through the same endpoint. The endpoint does not create a purchase or debit a wallet.

Catalogue behaviour

The list changes as brands, plans, availability and limits change. Cache it sensibly and refresh before purchase; never hardcode a brand count or product code. A plan can be a separate product even when several products share the same brand name.

partner_commission is your package display setting. percentage is a percentage rate; fixed is an INR amount; differing min/max values represent amount-dependent settings. A missing/ambiguous mapping is null, not zero. Use Gift Card Quote for the exact amount, taxes and debit.

Thumbnail/icon URLs are returned on the Pay2New domain. Treat product codes as opaque Pay2New identifiers.

Response examples

Illustrative values only. Always inspect the numeric JSON status and matching order references.

Catalogue

JSON

{
  "status": 1,
  "data": [
    {
      "product_code": 1004489,
      "name": "Flipkart",
      "thumbnail_url": "https://pay2new.in/giftcards/assets/1004489/thumbnail?v=ece5ae077eaa",
      "icon_url": "https://pay2new.in/giftcards/assets/1004489/icon?v=36608b1e5915",
      "categories": [
        "ELECTRONICS",
        "DIWALI_SPECIAL",
        "ONE_STOP_SHOPS"
      ],
      "tags": [
        "online shopping",
        "Electronics",
        "Mobiles",
        "phone",
        "Fashion",
        "Clothing",
        "Footwear",
        "Accessories",
        "Books",
        "Appliances",
        "Furniture",
        "Kitchen",
        "Beauty",
        "Toys",
        "Grocery",
        "Health",
        "Sports",
        "Fitness",
        "Bags",
        "Luggage",
        "Jewellery",
        "Watches",
        "Gaming",
        "Laptops",
        "Tablets",
        "Cameras",
        "Video",
        "TVs",
        "television",
        "Refrigerators",
        "Washers",
        "Conditioners",
        "Men",
        "Women",
        "Kids",
        "Smartphones",
        "HomeDecor",
        "Furnishing",
        "PersonalCare",
        "Stationery",
        "DIY",
        "Gadgets",
        "Software",
        "Printers",
        "Monitors",
        "Speakers",
        "Headphones",
        "Consoles",
        "Games",
        "HomeImprovement",
        "Garden",
        "Outdoor"
      ],
      "denomination_type": "FLEXIBLE",
      "amount_restrictions": {
        "minAmount": 50,
        "maxAmount": 10000,
        "minOrderAmount": 50,
        "maxOrderAmount": 10000,
        "minVoucherAmount": 50,
        "maxVoucherAmount": 10000,
        "maxVouchersPerOrder": 1,
        "maxVouchersPerDenomination": 1,
        "maxDenominationsPerOrder": 1,
        "denominations": null
      },
      "expiry_months": 12,
      "redemption_type": "ONLINE",
      "partner_commission": {
        "type": "percentage",
        "min": 1.5,
        "max": 1.5
      }
    }
  ]
}

Access error

JSON

{
  "status": 2,
  "message": "Oops, This service is not for you!"
}

Headers

Header	Required	Description
secret	Yes	Your Pay2New-issued partner API secret.
Content-Type	For JSON POST requests	application/json
Accept	Recommended	application/json

Your account, KYC, wallet, API access and Gift Card service must be active. Send requests from your registered backend IP. No outletId, browser session, or separate subscription credential is required by these endpoints.

cURL request

Shell

curl --request GET \
  --url 'https://pay2new.in/apis/v1/giftcards/brands' \
  --header 'secret: YOUR_PAY2NEW_SECRET' \
  --header 'Accept: application/json'