Skip to main content
POST
/
giftcard
/
order
Order
curl --request POST \
  --url https://base_url/giftcard/order \
  --header 'Authorization: Basic <encoded-value>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "amount": "1000",
  "productId": "APITESTTIMFAIL",
  "clientRefId": "TEST3456u7633e4",
  "quantity": "1",
  "userDetails": {
    "firstName": "ABCD",
    "lastName": "PQRS",
    "email": "ABCD@gmail.com",
    "mobile": "9876543210",
    "address": "Luckow",
    "landmark": "Lucknow",
    "state": "Uttar Pradesh",
    "city": "Lucknow",
    "pinCode": "226010"
  }
}
'
{
  "code": "0x0200",
  "status": "SUCCESS",
  "message": "Order Placed Successfully",
  "data": {
    "status": "success",
    "clientRefId": "23",
    "orderRefId": "GFT63347637C9DC67113",
    "txnId": "ABF5551438856",
    "cards": [
      {
        "sku": "CNPIN",
        "productName": "API TESTING - CN & PIN",
        "labels": {
          "cardNumber": "Gift Card Number",
          "cardPin": "Card PIN",
          "activationCode": "",
          "samsungWalletLabel": "",
          "sequenceNumber": "",
          "validity": "Validity"
        },
        "cardNumber": "8090920011622228",
        "cardPin": "288916",
        "activationCode": null,
        "barcode": "18009019220021156272262832",
        "activationUrl": null,
        "redemptionUrl": {
          "label": "",
          "url": ""
        },
        "addToSamsungWallet": "",
        "formats": [
          {
            "key": "CNONLY",
            "value": "8090920011622228"
          },
          {
            "key": "TRACK2",
            "value": ";8090920011622228=044500001225763?"
          },
          {
            "key": "QCBARCODE-26-V1",
            "value": "18009019220021156272262832"
          }
        ],
        "amount": "1000.00",
        "validity": "2026-04-21T16:02:46+05:30",
        "issuanceDate": "2025-04-21T10:32:46+00:00",
        "sequenceNumber": "",
        "cardId": 5610922,
        "recipientDetails": {
          "salutation": "Mr",
          "name": "ABCD PQRS",
          "firstname": "ABCD",
          "lastname": "PQRS",
          "email": "ABCD@gmail.com",
          "mobileNumber": "+919876543210",
          "status": "",
          "failureReason": ""
        }
      }
    ],
    "totalAmount": 1000
  }
}

Authorizations

Authorization
string
header
required

Basic authentication header of the form Basic <encoded-value>, where <encoded-value> is the base64-encoded string username:password.

Body

application/json
amount
string
required
productId
string
required
clientRefId
string
required
quantity
string
required
userDetails
UserDetails · object
required

Response

OK

code
string
required
status
string
required
message
string
required
data
Data29 · object
required