取得最佳優惠

getOfferQuote 如果你的目標是拿到最高的現金回饋率，getOfferQuote 查詢會依照你提供的條件，幫你找出特定商家的最佳可用優惠。

回應：

getOfferQuote 查詢的回應會回傳一個 Offer 物件，包含該商家最佳可用優惠的詳細資訊。

參數：

input (GetOfferQuoteInput!)：
用來指定尋找最佳優惠條件的輸入物件。此參數為必填，應包含商家的 slug 與其他相關細節。 GetOfferQuoteInput 欄位： slug (String!)：
商家的唯一 slug 識別碼。此欄位為必填。此 slug 用於指定要查詢哪個商家的優惠。你可以使用前面提到的 getMerchants 查詢來取得商家的 slug。 denomination (Float!)：
欲查詢優惠所對應的購買金額。此欄位同樣為必填，該金額會影響可用優惠。 paymentMethod (PaymentMethodType):
將用於此次購買的付款方式。預設為 FLUZPAY（你可用的 Fluz 餘額），但也可依優惠可用性指定其他付款方式，包括：

BANK_CARD
BANK_ACCOUNT
PAYPAL
FLUZPAY
APPLE_PAY
GOOGLE_PAY

範例用法：

以下示範如何撰寫一個 getOfferQuote 查詢：

query getOfferQuote($input: GetOfferQuoteInput!) {
  getOfferQuote(input: $input) {
    offeringMerchantId
    offerId
    type
    hasStockInfo
    offerRates {
      ...OfferRateFragment
    }
    denominationsType
    termsAndConditions
    stockInfo {
      ... on StockInfoVariableType {
        __typename
        description
        maxDenomination
        minDenomination
      }
      ... on StockInfoFixedType {
        __typename
        denomination
        availableStock
      }
    }
  }
}

回應詳細資訊

Offer 物件代表與該商家相關的優惠細節。 offeringMerchantId (UUID)：提供優惠的商家的唯一 ID。 offerId (UUID!)：優惠的唯一 ID。 type (OfferType)：指出優惠的類型。可能是標準禮品卡優惠或獨家費率優惠。[範例：GIFT_CARD_OFFER、EXCLUSIVE_RATE_OFFER]。 hasStockInfo (Boolean)：指定此優惠是否包含庫存資訊。若為 true，stockInfo 欄位會回傳可用面額。 denominationsType (OfferDenominationType)：定義此優惠可用面額的類型。用來描述優惠的面額結構，例如固定或可變面額。 termsAndConditions (String)：此優惠的條款與細則（法律文本、限制、到期政策）。在使用者購買禮品卡前請顯示此 T&C。 stockInfo ([StockInfoType]!)：StockInfo 是此優惠可用面額的清單。此欄位僅在 hasStockInfo 為 true 時可用，表示 Fluz 需確認庫存。請注意，回應時間會依供應商而異。stockInfo 會依 VARIABLE 或 FIXED 類型有條件地回傳資訊。欲查詢 stockInfo，你需要使用 ... on 關鍵字的 inline fragment。若面額類型為 VARIABLE 則回傳 StockInfoVariableType，若為 FIXED 則回傳 StockInfoFixedType。回應範例：

{
  "data": {
    "getOfferQuote": {
      "offeringMerchantId": "7b4280a6-dadc-4cf3-a99a-70d291e43c1c",
      "offerId": "7b4280a6-dadc-4cf3-a99a-70d291e43c1c",
      "type": "GIFT_CARD_OFFER",
      "hasStockInfo": true,
      "offerRates": [],
      "denominationsType": "VARIABLE",
      "termsAndConditions": "Card valid only for purchases on the merchant's U.S. website. Cannot be used to purchase other gift cards. Not redeemable for cash except where required by law.",
      "stockInfo": [
        {
          "__typename": "StockInfoVariableType",
          "description": "Available denominations range from $5 to $200",
          "maxDenomination": "200",
          "minDenomination": "5"
        }
      ]
    }
  }
}

更多細節請參考文章 GraphQL API 的運作方式。 OfferRate 物件代表與優惠相關的特定回饋比率與條件。此物件包含使用者在使用優惠時可獲得的回饋詳細資訊，以及這些回饋適用的條件： maxUserRewardValue (Float)：
使用者可獲得的最高現金回饋金額。此欄位定義了特定優惠可賺取的回饋上限。 cashbackVoucherRewardValue (Float)：
套用加碼後的現金回饋值。通常為消費前 $10 部分享有 25% 的現金回饋加碼。 boostRewardValue (Float)：
當優惠的現金回饋值被提高時，會顯示在此。這些優惠是在一段期間內提供給使用者的額外誘因。 displayBoostReward (Boolean)：
指出是否應向使用者顯示加碼回饋。此欄位用於控制介面中加碼回饋的可見性。 denominations ([String])：
符合優惠資格的面額陣列。這些面額代表可適用於優惠的特定金額（例如 “10”、“25”、“50”），用以定義可獲得回饋的金額。 allowedPaymentMethods ([String])：
此優惠允許使用的付款方式陣列。此欄位指定使用者可用來享有優惠的付款方式（例如 “CREDIT_CARD”、“PAYPAL”）。

🚧 現金回饋比率可能變動。我們會盡力為客戶提供最佳可用優惠，這表示比率會定期調整。請在購買前務必確認當下比率。

​回應：

​參數：

​範例用法：

​回應詳細資訊

回應：

參數：

範例用法：

回應詳細資訊