Inventory on Stocked Offers

Some of the denominations on select gift card brands are stocked. Other merchants only offer variable value gift cards that are generated in real time. If a gift card offer is stocked, that is generally a better rate or higher purchasing limits on that specific offer. It will be specific denominations that are generally stocked on a gift card brand. In order to see our inventory you will need to call the get stock information API call. That will allow you to see the exact quantity available for those specific denominations.

Some merchants have both variable and stocked gift card offers. Please determine which type of offer you are looking to purchase based on pricing and total volumes.

Using the Offer object from either the getOfferQuote or getMerchants query, you can determine stock availability.

If hasStockInfo is true, the stockInfo field will display a list of all available denominations that are currently in stock.
If hasStockInfo is false, any value denominations in the offerRates denominations field will be in stock.
If the denominationsType is "VARIABLE", you can purchase any value between the minimum and maximum denomination.
stockInfo is a list of available denominations for a specific offer. This field object is only available if the offer’s hasStockInfo is true. This requires Fluz to confirm the inventory. Keep in mind, the response time varies by vendors. The stockInfo field will conditionally return information depending on the VARIABLE or FIXED type. To query for stockInfo, you will need to utilize an inline fragment using the ... onkeyword. This will return StockInfoVariableType if the denomination type is VARIABLE or StockInfoFixedType if the denomination type is FIXED. In your getOfferQuote and getMerchants queries, you will have to include both StockInfoVariableType and StockInfoFixedType fragments. For more detail, refer to the How the GraphQL API works article.

JSON

"offerRates":[{
    "denominations": ["10","1000"]
}]

If the denominationsType is "FIXED", you will either:

If hasStockInfo is true, purchase a specific value in the stockInfo field. It will return either StockInfoVariableType or StockInfoFixedType conditionally depending on the denominationsType.

StockInfoVariableType

"stockInfo": 
  [
    {
      "__typename": "StockInfoVariableType",
      "description": "Available denominations range from $5 to $200",
      "maxDenomination": "200",
      "minDenomination": "5"
    }
  ]
,

StockInfoFixedType

"stockInfo": [
  {
    "__typename": "StockInfoFixedType",
    "availableStock": "200",
    "denomination": "5"
  }
]

If hasStockInfo is false, purchase a specific value in the offerRates denominations field.