获取最佳优惠

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 关键字的内联片段。如果面额类型为 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)：
应用加成后（boost）的返现金额。通常是在你消费的首个 $10 上提供 25% 的返现加成。 boostRewardValue (Float)：
当某个优惠的返现被提升时，会在此显示。这些是为一段时间内向用户提供的额外激励。 displayBoostReward (Boolean)：
指示是否应向用户展示加成奖励。该字段用于控制在用户界面中显示加成奖励。 denominations ([String])：
符合该优惠条件的面额数组。这些面额代表可适用的具体金额（例如：“10”、“25”、“50”），用以定义可获得奖励的金额范围。 allowedPaymentMethods ([String])：
该优惠允许的支付方式数组。此字段指定用户可用来参与该优惠的支付方式（例如：“CREDIT_CARD”、“PAYPAL”）。

🚧 返现比例可能会发生变化。我们尽最大努力始终为客户提供最佳可用优惠。这意味着我们的费率会定期变动。购买前请务必确认当前费率。

​响应：

​参数：

​示例用法：

​响应详情

响应：

参数：

示例用法：

响应详情