Validate the selected brand, denomination values, quantities and customer details, then calculate the exact Pay2New wallet price for your account. No voucher purchase or Pay2New wallet debit is created by this endpoint. A quote does not reserve funds or guarantee later availability.
Request body
| Field | Type | Required | Description |
|---|---|---|---|
request_id | string | Yes | 8–30 characters: letters, digits, _ or -. Unique in your account across environments and transaction services. Preserve it throughout retries. |
product_code | integer | Yes | Current Pay2New product code returned by List Gift Card Brands. |
denomination_details | array | Yes | 1–100 denomination/quantity entries. All current brand limits still apply. |
denomination_details[].denomination | number | Yes | Positive amount in INR, with at most 2 decimal places. Select an allowed fixed value or stay within the flexible voucher range. |
denomination_details[].quantity | integer | Yes | Positive integer, at most 1000 per submitted entry, and within the brand's quantity limits. Duplicate denominations are merged before validation. |
customer_details | object | Yes | Customer details for the order. |
customer_details.name | string | Yes | 2–50 Unicode letters/spaces. Numbers and punctuation are not accepted. |
customer_details.phone | string | Yes | Indian mobile: exactly 10 digits beginning with 6–9; omit country code and spaces. |
customer_details.email | string | No | Valid email of at most 100 characters. Omit or send empty to use the system default. |
amount | number | No | If supplied, it must equal the sum of denomination × quantity. |
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.
Response fields
Field in data | Description |
|---|---|
amount | Total voucher face value in INR. |
commission | Your calculated commission amount, not a percentage. |
surcharge | Applicable surcharge amount. |
tds | Applicable TDS amount. |
gst | Applicable GST amount. |
wallet_debit | Final calculated debit; preserve the returned precision. |
environment | Active environment. The documented base URL is live. |
Show these amounts for customer/partner review. Send data.wallet_debit as expected_wallet_debit to Purchase Gift Card to guard against a changed wallet price. A new quote should be reviewed after any brand, denomination, quantity, package or pricing change.
Response examples
Illustrative values only. Always inspect the numeric JSON status and matching order references.
Quote
{
"status": 1,
"data": {
"amount": 1000,
"wallet_debit": 985.3,
"commission": 15,
"surcharge": 0,
"tds": 0.3,
"gst": 0,
"environment": "production"
}
}
Invalid denomination
{
"status": 2,
"message": "Select an allowed fixed denomination."
}
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 POST \
--url 'https://pay2new.in/apis/v1/giftcards/quote' \
--header 'secret: YOUR_PAY2NEW_SECRET' \
--header 'Accept: application/json' \
--header 'Content-Type: application/json' \
--data '{
"request_id": "GC_PARTNER_20261016_0001",
"product_code": 1004489,
"denomination_details": [
{
"denomination": 1000,
"quantity": 1
}
],
"customer_details": {
"name": "Sample Customer",
"phone": "9000000001",
"email": "[email protected]"
}
}'
| Time | Status | User Agent | |
|---|---|---|---|
Retrieving recent requests… | |||