What is the Fluz API?

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 Using Fragments with Unions and Interfaces article.

"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.\
    "stockInfo": 
      {
        "__typename": "StockInfoVariableType",
        "description": "Available denominations range from $5 to $200",
        "maxDenomination": "200",
        "minDenomination": "5"
      }
    ,
    "stockInfo": [
      {
        "__typename": "StockInfoFixedType",
        "availableStock": "200",
        "denomination": "5"
      }
    ]
    • If hasStockInfo is false, purchase a specific value in the offerRates denominations field.\
    "offerRates": [{
        "denominations": ["10","100"]
    }]
    

Next Steps

Now it's time to purchase a gift card. But first, let's make sure you can fund your purchase. Learn how to do so here:

Add Funding Sources