获取最佳优惠

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 确认库存。请注意，响应时间因供应商而异。根据 VARIABLE 或 FIXED 类型，stockInfo 字段将有条件返回信息。要查询 stockInfo，你需要使用带有 ... on 关键字的内联片段。当面额类型为 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”）来享受该优惠。

🚧 返现费率可能发生变化。我们会尽力始终为客户提供最优优惠。这意味着我们的费率会定期调整。请在购买前务必确认费率。

​响应：

​参数：

​示例用法：

​响应详情

响应：

参数：

示例用法：

响应详情