Fetch current brand/plan details before showing a purchase form. This is a read-only lookup.
Path parameter
| Field | Type | Required | Description |
|---|---|---|---|
product_code | integer | Yes | Current Pay2New code returned by List Gift Card Brands. |
Denomination, validity and redemption
For FIXED brands, select from meta.amountRestrictions.denominations. For FLEXIBLE brands, stay between minVoucherAmount and maxVoucherAmount. In both cases, follow minOrderAmount, maxOrderAmount, maxVouchersPerOrder, maxVouchersPerDenomination and maxDenominationsPerOrder when present. The catalogue can change; refresh brand details before forming an order.
The example uses a catalogue product code observed when this documentation was prepared. Replace it with the current code and current limits returned to your account. Examples and monetary values are illustrative, not fixed commercial terms.
meta contains customer-facing information only: description, categories/tags, Pay2New artwork URLs, amount limits, card type, redemption type, validity, terms and how-to-use instructions. Read tncDetailed.sections[].items[] for structured terms and howToUseInstructions for the brand's current redemption process. storeLocatorUrl may be empty.
The canBalanceBeFetched metadata flag does not add a voucher balance enquiry endpoint to this API. For subscriptions, confirm the exact plan duration and eligibility from this product's name and conditions.
Response examples
Illustrative values only. Always inspect the numeric JSON status and matching order references.
Brand details
{
"status": 1,
"data": {
"product_code": 1004489,
"name": "Flipkart",
"meta": {
"brandDescription": "Shop with a Flipkart gift card.",
"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"
],
"denominationType": "FLEXIBLE",
"amountRestrictions": {
"minAmount": 50,
"maxAmount": 10000,
"minOrderAmount": 50,
"maxOrderAmount": 10000,
"minVoucherAmount": 50,
"maxVoucherAmount": 10000,
"maxVouchersPerOrder": 1,
"maxVouchersPerDenomination": 1,
"maxDenominationsPerOrder": 1,
"denominations": null
},
"cardType": "CARD_AND_PIN_NO_SECURED",
"redemptionType": "ONLINE",
"voucherExpiryInMonths": 12,
"termsAndConditions": [
"Redeem according to the current brand terms."
],
"tncDetailed": {
"sections": [
{
"title": "Important terms",
"items": [
{
"text": "Keep the gift card number and PIN confidential.",
"subItems": []
}
]
}
]
},
"howToUseInstructions": [
{
"retailModeName": "Online",
"instructions": [
"Apply the gift card number and PIN at the brand checkout."
]
}
],
"storeLocatorUrl": null,
"canBalanceBeFetched": false,
"iconUrl": "https://pay2new.in/giftcards/assets/1004489/icon?v=36608b1e5915",
"thumbnailUrl": "https://pay2new.in/giftcards/assets/1004489/thumbnail?v=ece5ae077eaa",
"logoUrl": "https://pay2new.in/giftcards/assets/1004489/logo?v=36608b1e5915"
}
}
}
Brand unavailable
{
"status": 2,
"message": "Gift Card brand not available."
}
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
curl --request GET \
--url 'https://pay2new.in/apis/v1/giftcards/brands/1004489' \
--header 'secret: YOUR_PAY2NEW_SECRET' \
--header 'Accept: application/json'
| Time | Status | User Agent | |
|---|---|---|---|
Retrieving recent requests… | |||