Create a Gift Card or subscription voucher order after reviewing Gift Card Quote. A valid new purchase debits your Pay2New wallet and can issue real vouchers. Send requests from your registered backend, not from the documentation page.

Request body

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.

Idempotency

Use the same request_id and the same normalized purchase details after a timeout. An existing matching order is returned without another debit. A changed payload with the same ID is rejected. Use a new ID only for a deliberate separate purchase, after resolving any earlier uncertain result. Request IDs cannot be reused across environments or other Pay2New transaction services.

The server validates active account/KYC/wallet, package/slab settings, current brand rules and sufficient available wallet balance. A successful quote alone does not guarantee the purchase.

Result handling

HTTP success alone does not establish purchase success. Match request_id, gift_order_id and order_id; read the numeric JSON status. order_status adds context and may be UNSUBMITTED, UNKNOWN, PROCESSING, SUCCESS, FAILED, REVERSED or CANCELLED. A cancellation may remain unresolved until the refund is confirmed. Use the numeric result and needs_review to decide the client state.

Response fields

Voucher credentials

id, amount and brand-supplied validTill describe each issued voucher. Do not assume both credentials exist for every brand. Vouchers are returned in the response only after validated success; handle customer delivery in your own application. This endpoint does not send SMS, email or WhatsApp delivery.

On a network timeout or status: 3, begin checking the original order after one minute, then use controlled intervals/backoff. Do not create a replacement order. A confirmed failed/reversed order is refunded through the existing Pay2New wallet flow. Cancellation or timeout alone does not confirm a refund.

Response examples

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

Processing order

{
  "status": 3,
  "gift_order_id": 123,
  "order_id": "P2F_SAMPLE_ORDER",
  "request_id": "GC_PARTNER_20261016_0001",
  "order_status": "PROCESSING",
  "environment": "production",
  "product_code": 1004489,
  "message": "Gift Card order is processing.",
  "amount": "1000.0000",
  "wallet_debit": "985.3000",
  "commission": "15.0000",
  "surcharge": "0.0000",
  "tds": "0.3000",
  "gst": "0.0000",
  "balance": "4014.7000",
  "needs_review": false,
  "vouchers": []
}

Successful order

{
  "status": 1,
  "gift_order_id": 123,
  "order_id": "P2F_SAMPLE_ORDER",
  "request_id": "GC_PARTNER_20261016_0001",
  "order_status": "SUCCESS",
  "environment": "production",
  "product_code": 1004489,
  "message": "Gift Card generated.",
  "amount": "1000.0000",
  "wallet_debit": "985.3000",
  "commission": "15.0000",
  "surcharge": "0.0000",
  "tds": "0.3000",
  "gst": "0.0000",
  "balance": "4014.7000",
  "needs_review": false,
  "vouchers": [
    {
      "id": "SAMPLE_VOUCHER_001",
      "cardType": "CARD_AND_PIN_NO_SECURED",
      "amount": 1000,
      "validTill": "2027-10-15",
      "cardNumber": "EXAMPLE_CARD_NUMBER",
      "cardPin": "EXAMPLE_CARD_PIN"
    }
  ]
}

Failed and refunded

{
  "status": 2,
  "gift_order_id": 123,
  "order_id": "P2F_SAMPLE_ORDER",
  "request_id": "GC_PARTNER_20261016_0001",
  "order_status": "FAILED",
  "environment": "production",
  "product_code": 1004489,
  "message": "Gift Card order failed/reversed; wallet refunded.",
  "amount": "1000.0000",
  "wallet_debit": "985.3000",
  "commission": "15.0000",
  "surcharge": "0.0000",
  "tds": "0.3000",
  "gst": "0.0000",
  "balance": "5000.0000",
  "needs_review": false,
  "vouchers": []
}

Review required

{
  "status": 3,
  "gift_order_id": 123,
  "order_id": "P2F_SAMPLE_ORDER",
  "request_id": "GC_PARTNER_20261016_0001",
  "order_status": "PROCESSING",
  "environment": "production",
  "product_code": 1004489,
  "message": "Gift Card service confirmation requires review.",
  "amount": "1000.0000",
  "wallet_debit": "985.3000",
  "commission": "15.0000",
  "surcharge": "0.0000",
  "tds": "0.3000",
  "gst": "0.0000",
  "balance": "4014.7000",
  "needs_review": true,
  "vouchers": []
}

Price changed

{
  "status": 2,
  "message": "The wallet price has changed. Review the order again."
}

Headers

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/orders' \
  --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]"
  },
  "expected_wallet_debit": 985.3
}'