文法

客戶結帳時，「端對端訂購」會顯示小費選取器。如此一來，客戶就能選擇訂單時可納入的寬限期數量。

端對端排序會傳送 SubmitOrderRequestMessage 中的所選金額，做為 ProposedOrder.otherItem 類型的 GRATUITY 的 LineItem。

如何隱藏小費選取器

您可以在商品目錄資料動態饋給中使用 ServingConfig.disableTipWidget，隱藏餐廳服務的小費選取器。

如何設定預設小費金額

您可以在結帳時設定預設小費金額，或拒絕接受服務費。CheckoutResponseMessage 支援以下用途：

  • 餐廳需要固定金額制

    在 CheckoutResponseMessage 的 ProposedOrder.otherItems 中，新增 GRATUITY 類型的委刊項，並在當中加入固定金額。

    JSON

    {
  "name": "Required Tip",
  "type": "GRATUITY",
  "price": {
    "type": "ESTIMATE",
    "amount": {
      "currencyCode": "USD",
      "units": "3",
      "nanos": 100000000
    }
  },
  "gratuityExtension": {
    "gratuityType": "MANDATORY"
  }
}

  • 餐廳顯示會向顧客表示餐點，並讓客戶選擇修改金額

    在 CheckoutResponseMessage 的 ProposedOrder.otherItems 中，新增 GRATUITY 類型的委刊項，並設定固定金額。請務必一併新增 gratuityType 值為 USER_MODIFIABLE 的 gratuityExtension。

    JSON

    {
  "name": "Suggested Tip",
  "type": "GRATUITY",
  "price": {
    "type": "ESTIMATE",
    "amount": {
      "currencyCode": "USD",
      "units": "3",
      "nanos": 100000000
    }
  },
  "gratuityExtension": {
    "gratuityType": "USER_MODIFIABLE"
  }
}

  • 餐廳不接受任何小費

    在 CheckoutResponseMessage 的 ProposedOrder.otherItems 中，新增 GRATUITY 類型的委刊項，並在其中加入空白金額。

    JSON

    {
  "name": "Tip",
  "type": "GRATUITY",
  "price": {
      "type":"ESTIMATE",
      "amount": {
        "currencyCode":"USD"
    }
  }
}