取得最佳優惠

getOfferQuote 如果你的目標是取得最高的現金回饋比例，getOfferQuote 查詢可協助你根據所提供的條件，為特定商家找出可用的最佳優惠。

回應：

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

參數：

input (GetOfferQuoteInput!)：
用來指定擷取最佳優惠準則的輸入物件。此輸入為必填，應包含商家的 slug 以及其他相關細節。 GetOfferQuoteInput 欄位： merchantSlug (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”）。

🚧 現金回饋比例可能會變動。我們致力於持續為客戶提供最佳可用優惠。這也表示我們的回饋比例會定期調整。請在購買前務必再次確認回饋比例。

​回應：

​參數：

​範例用法：

​回應細節

回應：

參數：

範例用法：

回應細節